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H 게•參於경 Eclipse 


머 리 말 

위대 한 령 도자 김정 일 동지 께 서 는 다음과 같이 지적 하시 였 다. 

《프로그람을 개발하는데서 기본은 우리 식의 프로그람을 개발하는것입니다. 우리는 
우리 식의 프로그람을 개발하는 방향으로 나가야 합니다.》(〈〈김정 일 선집》제15권, 196페지) 

위대한 장군님의 원대한 구상에 따라 우리식 조작체계의 개 발이 힘 있게 추진되고있 
는 오늘 여기에 필요한 프로그람개발도구를 갖추는것이 중요한 문제로 나서고있다. 우리 
식 조작체계에 기초하여 인민경제 여러 부문에서 필요되는 응용프로그람들을 충분히 보 
장하려 면 여 러 가지 기 능을 유연하게 구성할수 있는 통합개 발환경 을 가전 프로그람개 발도 
구가 있어 야 한다. 

Eclipse 는 이 와 같은 현실적 요구를 만족시 킬수 있는 공개원천통합개 발환경 으로서 
쏘프트웨 어개 발에 종사하는 전문가，기 술자들의 높은 평 가를 받고있으며 널 리 리 용되 고 
있 다. 

우리 는 Eclipse 를 조선어 환경 에 적 응시키 고 기 능을 전용화한 우리 식 의 조작체 계 개 
발도구로 전환시키는데서 초보적 인 성과를 거두었다. 

이 책에서는 통합개발환경 Eclipse 에 대한 일반적지식과 Eclipse 를 리용한 Java 프 
로그람작성， Web 응용프로그람개 발을 비 롯한 여 러 가지 개 발방법 들을 서 술하고있 다. 

이 책 은 이 미 최 신개 발도구를 습득하고 우리 식 의 쏘프트웨 어개 발에 참가하여 지 혜 
와 정열을 다 바치고있는 이 부문 전문가，기술자들에게 참고가 되는것은 물론이고 앞날 
의 주인공들인 우리의 대학생들에게도 좋은 길동무가 되리라고 본다. 
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‘ 제 Mh Eclipse 多 ! 게요 


제1장. Eclipse 의 개요 

제1절. Eclipse 란 무엇인가 

Eclipse 는 Eclipse Foundation 라는 단체 가 개 발하고있는 개 발도구를 위 한 가동기 
반이다. Eclipse 는 여러 개의 부분프로젝트를 가지고있고 Eclipse 의 표준개발묶음 
(Eclipse SDK ) 에는 JDT(Java Development Tools ： Java 개발도구)라고 하는 Java 
통합개 발환경 ( IDE ) 도 포함되 여 있 다. 

Eclipse 의 기본목적의 하나는 공개원천으로 상업수준의 높은 기능의 개발환경을 제 
공하는것이다. 무상으로 제공되는 기본적인 Java 개발환경만 가지고도 실용성이 충분하 
며 직업적개발전문가들이 즐겨 리용하고있다. 사실상 Eclipse 자체도 Eclipse 로 개발되 
고있 다. Eclipse 본체 는 공개원천 이 고 Common Public License ( CPL ) 또는 Eclipse 
Public License ( EPL ) 라고 하는 상업 적 리 용에 서 허 용도가 높은 허 가를 적 용할수 있 다. 

Eclipse 의 특징 을 세 가지로 볼수 있다. 

첫째 로，고속사용자대 면부이다. 

Eclipse 의 표준도형 사용자대면부에는 SWT(Standard Widget Toolkit : 표준부품도 
구묶음) 라고 하는 Swing 보다 가볍 고 속도가 빠른 일 반도형 서고가 리 용되 므로 Swing 
에 의존하는 응용제품보다 더 좋은 조작성을 실현하고있다. 

둘째 로，높은 기 능을 갖춘 Java 개 발환경이 다. 

Ant , JUnit 등 Java 의 표준적 인 개발도구를 지원할뿐아니라 건기능，오유수정 기능， 
CVS (Concurrent Versions System ： 병행 판본체계) 등의 판본관리체계의 지원을 비롯 
하여 Java 통합개 발환경 으로서 의 기 능을 기 본적 으로 갖추고있 다. 

셋째로，끼워넣기 ( plug - in ) 에 의한 확장성을 가지고있다. 

Eclipse 의 모든 기능은 다 끼워넣기에 의하여 실현된다. 그러므로 필요한 기능을 
가지는 끼워넣기를 조합함으로써 자기가 바라는 개발환경을 구축할수 있다. 표준적인 구성을 
가진 Eclipse 에는 끼워넣기를 개발하기 위한 PDE ( Plug-in development environment ： 끼 
워넣기개 발환경)가 갖추어져 있으므로 끼워넣 기개 발도 Eclipse 로 할수 있다. Eclipse 는 
설계형태를 제기한 Eric Gamma 를 비롯하여 세계적으로 유명 한 프로그람개발자들이 개 
발리용하고있는 도구이다. 즉 Eclipse 는 단순한 초보자용도구가 아니라 전문가들이 실 
제 로 개 발현장에서 쓰면서 발전시 켜 온 특색있는 도구이 다. 
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1.1.1. Eclipse 의 력사 

1999년에 OTI(Object Technology International : 객체기술국제협의회)와 IBM 이 
공동으로 공개 가동기반인 Eclipse 개 발을 시 작하였 다. Eclipse 는 개 발 첫 시 기 부터 40명 
의 전문개발자들에 의하여 본격적인 개발이 진행되였으며 2001년에는 정식으로 공개원 
천화되여 Eclipse 련맹이 설립되였다. 

Eclipsel . O 은 20()1 년 10월에 발표되고 11월에는 eclipse . org 거점이 생겨 내리적 
재가 가능하게 되였다. 2002년 6월에는 Eclipse 2.0 이 발표되였는데 Eclipsel . O 에 비하 
여 조작성 이 개선되 고 끼워넣 기의 설치와 갱 신기능이 추가되 였다. 그후 2003년 3월에 
2.1 이 발표되고 2.1.1 을 거쳐 2.1.3 까지 발표되였다. 2004년 6월에는 Eclipse 3.0 이 
발표되였다. Eclipse 3.0 에서는 사용자들의 요청을 받아들여 사용자대면부가 많이 개선 
되 였다. 또한 통합개 발환경의 가동기 반으로서 뿐아니 라 다기능 의뢰기응용프로그람의 가 
동기반으로서 의 기 능도 추가되 였 다. Eclipse 3.0 은 리 용범 위 를 도구에 극한시 키 지 않고 
실행환경까지 확장한 가동기반이 라고 말할수 있다. 


표 1-1. 


Eclipse 의 력사 

1999 년 

4 월 

OTI/IBM 의 내부에서 Eclipse 개발시작 

2000 년 

6 월 

Eclipse Technique Preview 를 발표 

2001 년 

3 월 

첫 Eclipse 거 점 

(http : / / www. eclipsecorner. org/) 개 설 


6 월 

Eclipse0.9 발표 


10 월 

Eclipsel.O 발표 


11 월 

IBM 이 Eclipse 원천코드를 기증 하여 IBM 외 9 개 회사가 주도성원이 되여 
Eclipse 련맹 이 설 립 Eclipse 거 점 (http : // www. eclipse, org/) 이 개 설 

2002 년 

3 월 

3 개 회사가 새 로 주도성 원으로 참가 


6 월 

6 개 회사가 주도성원으로 참가， Eclipse2.0 발표 


8 월 

Eclipse2.0.1 발표 


9 월 

2.0 용국제화모둘발표， Oracle 이 주도성원으로 참가 


11 월 

Eclipse2.0.2 발표 


12 월 

OMG(Object Management Group) 가 주도성 원으로 참가 

2003 년 

3 월 

Eclipse2.1 발표， Eclipse3.0 개발계획을 발표 


7 월 

Eclipse2.1.1 발표， Eclipse2.1.x 용국제화모둘발표， Intel 이 

주도성원으로 참가 

2004 년 

2 월 

Eclipse 가 독립단체로 재편성，첫 Eclipse 국제 토론회 개최， Eclipse 
Plugin Central (http://www.eclipsepluginCentral.com /) 개설 


6 월 

Eclipse3. 0 발표 


9 월 

Eclipse3. 0. 1 발표， Eclipse3. 0. 1 용국제 화모둘발표 
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1.1.2. Eclipse 프로젝트 

Eclipse 프로젝 트개 발은 공개 원천독립 단체 인 Eclipse 기 금 (Eclipse Foundation) 에 
의 하여 추진되 고있다. 이것은 처 음에 Eclipse 련맹 이 던것 이 2004 년에 첫 Eclipse 국제 토 
론회 가 개최되면서 독립단체로 재결성되 였다. 2004 년 9 월 eclipse.org 안에는 5 개 프로 
젝트가 존재하였다. 이 프로젝트들은 프로젝트관리위원회 (PMC) 에 의하여 관리되고있다. 

라*© 2? s © 보기(보) 바로 가기© 역 snn ®》 도구 (d sswtM ) 

- 는方 향 J http ： y/www.eclipse.org/ 一日 0*71 切， 

Quueuuois 나라 sib 기 tis ssb 사 % sa 지， 대학학 1 그기&소« 田사 



그림 1-1. eclipse. 아 g 거점 


표 1-2. Eclipse 프로젝트의 개팔 


프로젝트 

부분프로젝트 

프로젝트의 목적 

The Eclipse 
Project 

Platform 

도구의 통합을 위한 가동기 반의 핵 심 
기틀을 제공 


JDT - Java 
development tools 

Java 통합개발환경을 위한 끼워넣기를 
제공 


PDE - Plug-in 
Development environment 

끼워 넣 기개 발을 위한 환경 제공 

The Eclipse 
Tools Project 

Hyades 

쏘프트웨어의 품질보증을 위 한 도구를 
제공 


C/C++ IDE 

C 와 C++ 를 위한 통합개 발환경 제 공 


Graphical EditorFramework 
(GEF) Project 

GUI 편집 기 를 위한 기 틀 제 공 


EMF 

XML 에 의한 Java 코드생 성 의 기 틀을 
제공 


COBOL 

COBOL 를 위한 통합개발환경 제공 
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프로젝트 

부분프로젝트 

프로젝트의 목적 


VE (Visual Editor) 

Eclipse 에 의 한 GUI 건 립 기 를 제 공하 
는 프로젝트이며 Swing/JFC 와 SWT 
건립기의 참조를 제공 


UML2 

EMF 를 기초로 하는 UML2.0 의 메 타 
모형 을 제 공하기 위한 프로젝 트 

The Eclipse 
Technology 
Project 

Aspect Development Tools AspectJ 를 위 한 개 발도구 제 공 

Project (AJDT) 


AspectJ 

Java 에 의 한 Aspect 지향프로그람작성 
을 위한 연구를 진행 


CME (Concern Manipulation Aspect 지 향개 발을 위 한 통합가동기 반 
Environment) 을 제 공 


ECESIS (EclipseCommunit 
y Education Project) 

Eclipse 의 교육과 훈련용내용물을 개 
발，추진 


Equinox 

끼워넣 기확장，끼워넣기의 의존관계를 
동적 으로 변경하는 물림 새 를 조사 


Generative Model 
Transformer (GMT) 

모형 구동쏘프트웨 어 개 발을 지 원 하는 도 
구계렬 정비 


Pollinate 

Apache Beehive 기 틀을 위 한 개 발환 
경을 구축하는 프로젝트 


Koi 

협력개발을 위한 도구 제공 


Stellation 

Eclipse 에 의한 쏘프트웨어구성관리에 대 
한 연구를 진행 


OMELET (Open 

Modeling Environment 
With Links for Extensions 
and Transformations) 

각이한 모형 의 표현，모형 변환， 

모형변환기술을 통합하는 기틀을 제공 


XSD 

XML Schema 를 해석 하고 조작하기 
위 한 서 고를 제 공 


WSVT (Web Service 
Validation Tools) 

웨브봉사의 개발，배포，시험， 

오유수정 을 위 한 검 증도구를 제 공 

The Eclipse 
Web Tools 

Web Standard Tools 

Eclipse 를 기초로 하는 웨브응용프로 
그람의 공통개발환경을 제공 

Platform 

Project 

J2EE Standard Tools 

Eclipse 를 기 초로 하는 J2EE1.4 기준 
의 응용프로그람의 공통개발환경을 
제공 
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프로젝트 

부분프로젝트 

프로젝트의 목적 

The Eclipse 
Test and 
Performance 
Tools Platform 
Project 


Eclipse 를 사용한 공개적인 시험도구 
의 가동기 반을 제공，현재 Hyades 프 
로젝 트를 재 편성하여 프로젝 트작성중 

Business 

Intelligence 

And 

Eclipse Report 
Designer ( ERD ) 

보고서설계 를 위한 탁상창작도구의 개 
발프로젝 트 

ReportingTool 

s ( BIRT)Projec 

t 

Web BasedReport 

Designer ( WRD ) 

자료조작을 위한 HTML 기 초의 보고 
서 를 작성할수 있는 도구설계환경 을 
제공 


Eclipse Report 

Engine ( ERE ) 

보고서 의 생 성 및 표시 를 위한 응용프 
로그람개 발을 진행할수 있게 한다 


Eclipse Charting Engine 
( ECE ) 

도표생성을 위한 부품을 제공 

계획중에 있는 
부분프로젝트 

The Eclipse 

Communications Project 

Eclipse 를 사용한 통보전달 및 통신응 
용프로그람의 기능을 제공 


The Voice Tools Project 

W 3 C 표준을 기초로 하는 JSP / J 2 EE 에 
서의 음성응용프로그람에 초점을 둔 
프로젝 트 


The Embedded Rich Client 매 몰형 계 렬 의 다기 능의 퇴 기 환경 을 제 
Platform ( eRCP ) Project 공하는 프로젝트 


The Eclipse Project 는 견고하고 많은 기 능을 가진 시 장류통제 품수준의 쏘프트웨 어 
개발환경실현을 목적으로 하고있다 . 이 프로젝트는 3개의 부분프로젝트로 갈라져있으며 
각각 Eclipse 의 핵심부분， Java 통합개 발환경 ( JDT )， 끼워 넣 기개 발환경 ( PDE ) 을 제공한 
다. 이 3개의 부분프로젝트는 Eclipse - SDK 로서 묶어서 내 리적재할수 있다. 

The Eclipse Tools Project 는 Eclipse 를 위 한 여 러 가지 도구들을 만들어 내 는 프 
로젝트이 다. 이와 같은 프로젝트가 eclipse . org 안에 있는것으로 하여 각이한 끼워넣 기 
의 기능이 겹 치지 않도륵 조정 할수 있다. 그리 하여 The Eclipse Tools Project 의 개 발 
경험을 The Eclipse Project 에 되돌려 도입하려는 목적도 있다. 

The Eclipse Technology Project 는 Eclipse 의 발전에 기 여 하는 공개 원천개 발자 
와 연구사，교육자를 위한 프로젝 트이 다. 이 프로젝 트는 연구，발명，교육의 3가지 부 
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류로 나눈다. 

The Eclipse Web Tools Platform Project 는 Web 응용 및 J 2 EE 응용프로그람개 
발을 위한 가동기 반을 제 공하는 프로젝 트이 다. 특정한 쏘프트웨 어 개 발자에 치 우치 지 않 
는 중립적이며 표준적인 도구에 대한 기본적인 가동기반을 제공한다. 

The Eclipse Test and Performance Tools Platform Project 는 시험도구의 가 
동기반을 제 공하는 프로젝 트이 다. Eclipse Tools Project 안의 Hyades 프로젝 트를 재 편 
성하여 추진할 계획이다. 

Business Intelligence and Reporting Tools ( BIRT ) Project 는 업무지능화를 
위한 도구를 제 공하는 프로젝 트이 다. 2004년 10월 에 정 식 으로 Eclipse 의 프로젝 트로 되 
였 다. 

Eclipse 프로젝 트개 발은 공개원천 방식 으로 진행 되 고있으며 많은 개 발자들이 개 발에 
참가하여 부단히 판본갱신이 진행되고있기때문에 프로젝트의 내용은 계속 변하고있 다. 

1.1.3. Common Public License 와 Eclipse Public License 

Eclipse 2 .x 까지의 Eclipse 프로젝트의 성과는 공용허가 ( CPL:Commmon Public 
License ) 라는 허가로 배포되여있다는것이다. CPL 은 공개원천추진단체 ( OSI : Open 
Source Initiative , http :// www . opensource . org /) 가 인정 하는 공개 원천쏘프트웨 어 
의 정의를 만족시키고있어 승인된것 이다. 

Eclipse 3 .x 부터는 Eclipse Public License ( EPL : http : // www . eclipse , org / legal / epl - vlO . html ) 
라는 허 가로 제 공되 도록 변경 되 였 다. EPL 도 OSI 가 인정 하는 공개원천허 가이 며 기 본적 
으로는 CPL 와 거 의 같다. 주되 는 차이 점 은 CPL 이 IBM 에 의하여 규정 된것 이 라면 
EPL 는 Eclipse 기 금에 의 하여 규정되 였다는것과 특허 에 관한 조항이 변경되 여 있다는것 
이 다. Eclipse 의 모둘속에 는 CPL 이 나 EPL 이 외 의 공개원천허 가가 적 용되 여있는것 도 있 
다. 또한 eclipse.org 이외의 끼워넣기는 공개원천이 아닌것도 있기때문에 상업적목적에 
리용하려는 경우에는 허가를 받았는가를 확인할 필요가 있다. 


Eclipse 의 상업적리용 

Eclipse 는 여러 기업들이 리용하고있다. IBM 의 개발도구인 IBM Rational 
Application Developer 등은 Eclipse 가동기반상에 만들어 져있 다. 그외에 자료기지 
의 개발도구나 ERP 를 위한 개발도구들에도 Eclipse 가동기반이 사용되고있다. 
Eclipse 는 개발도구의 생태계 ( Ecosystem ) 를 제공하기때문에 매 개발업자들은 개발 
원가삭감，제품의 호환성과 같은 리익을 향유할수 있다. 사용자들도 공통의 도형사용 
자대면부나 조작성 으로하여 새 로운 도구에도 재빨리 적 응할수 있다는 우점 이 있다. 
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1.1.4. Eclipse 가동기반의 개요 

Eclipse 는 개 발도구를 위한 확장가능한 가동기 반이 다. Eclipse 가동기 반은 각이한 
환경 에 대 응하기 위하여 Java 가상기 계 상에 구축되 여있 다. 

Eclipse 3.0 이 대응하고있는 조작체계는 Linux , Windows , AIX , HP - UX , MacOS 
표이 다. Eclipse 는 Java 실행환경 (Java Runtime Environment : JRE ) 을 리용하고있기때 
문에 매개 조작체계환경에서의 Java 실행환경이 필요하게 된다. 

Eclipse 가동기반의 특징중의 하나는 도형사용자대면부로 SWT 를 리용하고있는것이 
다. SWT 는 일반도형서고와 단추，목록，본문 등 부품의 집합체 이다. Java 도형사용자대 
면부환경에서 Swing 이 있으면서도 SWT 를 쓰는데는 그럴만한 리유가 있다. 그것은 복 
잡하고 비교적 뜨다고 평가되는 Swing 부품에 비하여 실용적인 면에서 간단하고 고속으 
로 동작하는 화면부품을 제공하기 위해서이다. SWT 가 제공하는 화면부품중에는 Java 를 
쓰지 않고 고유코드 (native code ) 로 되여있는것이 있기때문에 순수한 Java (Pure Java ) 코 
드로 되 여있다고는 말할수 없다. 때문에 SWT 를 사용한 응용프로그람을 동작시키 자면 
Java 실행환경외 에 swt.dll 의 2진파일을 설치할 필요가 있다. 그러 나 많은 조작체계 에 
대 응하는 swt.dll 이 제공되 여 있기때 문에 사실상 Eclipse 는 가동기 반에 무관계 하게 쓸수 
있 다. 


Help 

(optional) 


Update 

(optional) 


t 

Text 

(optionaljj 

IDE 
Text 。 

r ， 

Compare 

ᄂ j 

r 거 

Debug 

L J 

Search 

Team 

Levs J 

(C IDE ) 



Java VM 


그림 1-2. Eclipse 의 개요 


Eclipse 의 기능을 확장하기 위한 물림새 가 끼워넣기 이다. Eclipse 의 화면에 표시되 
여 있는 차림표나 편집기，대화칸 등은 모두 끼워넣기 에 의하여 이루어 진것 이 다. 
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Java 

개발환경 

(JDT) 


Eclipse 가동기반 



작업대 


1 JFace 


: §WT ，ᅵ 

- j 


) 1 도움말 ! 



가동71반 실행시간 


■ Eclipse 프로젝트 

、_ ■ ■#!* 



그림 1-3. Eclipse 의 구성 


그림 1-3 에서 보는바와 같이 Eclipse 프로젝트외의 끼워넣기를 추가하거 나 자체로 
개 발한 끼워넣기를 추가할수도 있다. Java 개 발환경인 JDT 나 끼워넣기개 발환경인 PDE 
자체도 Eclipse 가동기반에 대한 끼워넣기이다. JDT 를 리용하여 Java 개발을 진행하는것 
뿐이 라면 Eclipse 내부의 구성을 알 필요는 없다. 그러 나 Eclipse 의 우월성은 끼워넣 기 
를 개발하거나 추가함으로써 자기가 바라는대로 환경을 구축할수 있다는데 있다. 그러자 
면 Eclipse 의 내부구성을 알고있어 야 한다. 

• 끼워넣기의 구성방식 

끼워넣기의 구성방식을 그림으로 표시하면 그림 1-4 와 같다. 



creates, calls 

그림 1-4. 끼워널기의 구성방식 
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그림 1-4 에서는 끼워넣기 B 로부터 끼워넣기 A 의 기능을 리용하는 형식을 보여주고있 
다. 끼워넣기묘의 모둘은 확장점 에 대 한 기 여를 선언한다. 실지 동작흐름은 Eclipse 가동 
기반으로부터 끼워넣기 B 가 호출되는 형식으로 된다. 이렇게 함으로써 원래부터 있던 끼 
워넣기 A 를 변경함이 없이 A 의 기능을 리용한 끼워넣기묘를 추가할수 있다. 사실 PDE 
의 끼워넣 기는 JDT 끼워넣 기를 리용하여 만들어져 있다. Eclipse 가동기 반은 이와 같은 끼 
워넣기의 물림새를 갖춤으로써 기존 끼워넣기를 리용한 기능확장을 실현하고있다. 

Eclipse 에 서 는 어 떤 기 능을 제 공하는 끼 워 넣 기 의 총체 를 특성 정 보 ( feature ) 라고 부 
른다. 그러 므로 JDT 는 Java 개 발을 위한 특성 정 보라고 말할수 있 다. 

• 작업대 

작업 대 (work bench ) 란 Eclipse 의 사용자대 면부 즉 Eclipse 창문안에 서 의 각종 보 
기 의 총체 이 다. 작업 대 에 는 SWT 》} JFace 가 포함된 다. 

SWT 는 Eclipse 화면을 작성 하기 위 한 도형 사용자대 면부도구함이 다. 

SWT 의 특징은 간편성，최소구성，고속성을 가지며 조작체계에 의존하지 않는 응용 
프로그람대면부 ( API ) 와 고유한 화면부품을 만들수 있는것이다. 

Swing 을 쓰지 않고 고유한 화면부품을 쓰기때문에 매 조작체계의 표준대면부와 류 
사한 대면부형식을 실현하여 고속으로 동작시킬수 있다. SWT 를 리용하여 사용자대면부 
의 공통과제부분을 실현하는 물림새를 제공하는것이 JFace 이다. 대화 ( dialog ), 나무보 
기 창 (tree view ) , 조수 ( wizard ) 등의 비 교적 조립 도가 큰 화면부품이 준비 되 여 있다. 
JFace 의 응용프로그람대면부는 조작체계에 의존하지 않도륵 만들어져 있다. 

• 작업공간 

작업공간은 작업령역을 제공한다. 구체적으로 말하면 원천파일 등의 각종 자원이나 
설정 과 같은것 을 보존하는 장소이 다. Eclipse 가 관리하는 각종 자원은 다 작업 공간안에 
보존된다. 

• 도움말 

말그대 로 도움말을 제 공한다. Eclipse 의 도움말체계는 웨 브를 기 초로 하고있어 도움 
말의 내용을 HTML 로 서술할수 있다. 또한 검색 이나 책갈피 ( bookmark ) 등 도움말을 
지 원하는 물림 새 도 제 공하고있 다. 도움말체 계 는 Java 의 API 문서표시 등에 도 쓰인 다. 
표준적 인 SDK 의 도움말에는 Eclipse 의 기 능설명 이 나 개 별지 도서 등이 포함되 여있다. 

• 오유수정 

오유수정 은 프로그람의 실행，멈춤점，오유수정사용자대 면부 등의 오유수정기능을 
위한 물림 새 를 제 공한다. 
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Eclipse 3. 0의 새로운 기능 

Eclipse 3. 0은 Eclipse 2 .x 에 비해 다음과 같은것들이 갱신되였다. 

• 사용자대면부의 개선 

기동할 때의 [ Welcome ] 화면이 새롭게 만들어지고 개별지도서나 목록 등이 추 
가되 였 다. 또한 요약 및 묘리 기 능 (tips and tricks ) 에 대 한 설명 등이 추가되 여 있다. 
그외에도 설계가 개선되고 보기의 겹침표시가 갱신되였다. 

• SWT , 본문，갱신，조，검색， Ant 기능의 개선 

Eclipse 가 제공하는 가동기반이 가지는 기능과 응용프로그람대면부가 확장되였 
다. 례 하면 과제 접 시 (task tray ) 의 도형 사용자대 면부가 추가되 였 거 나 끼 워 넣 기 의 갱 
신 등이 진행되였다. 

• JDT , 오유수정， PDE 기능의 개선 

JDT 와 Java 가 가지고있는 개 발기능이 강화되 였다. 개편의 명 칭을 변경할 때 
설명 문도 갱 신되 게 된것 이 라든가 추상문법 나무보기 창 (AST View ： abstract 
syntax tree View ) 의 추가 등 개선된 점들이 많다. 


1.1.5. 여 러 가지 끼워넣 기 

Eclipse 에는 여 러 가지 끼워넣 기들이 제공되 여있다. Eclipse 에서 리용할수 있는 끼 
워넣기는 너무 많아서 여기서는 다만 필요한 끼워넣기들이 있는 주요 거점을 소개 하기로 
한다. 주의해야 할것은 Eclipse 3.0 의 기술명세서가 Eclipse 2.0 과 완전한 호환이 진행 
되는것은 아니 라는것 이 다. 따라서 Eclipse 2 .x 용끼워 넣기 가 Eclipse 3.0 에서 그대 로 동 
작하지 않을수 있다. 끼워넣 기를 리용할 때 에는 반드시 대 응되는 Eclipse 의 판본을 확 
인하여 야 한다. 

• Eclipse plugins http :// www . eclipse - plugins.info 

Urbaan 이 관리 하는 Eclipse 용끼워 넣기가 들어 있는 거점 이 다. 650개 이상의 끼워 넣 
기 가 분야별 로 등록되 여있 다. 

• Eclipse plugin Central http :// www . eclipseplugincentral.com 

Eclipse 용끼 워 넣 기 의 류통을 위 한 시 장거 점 이 다. 

• SourceForge http :// sourceforge.net 

Eclipse 용끼워 넣 기뿐아니 라 공개원천프로젝트들에 대 한 거점 이 다. 
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제2절. 설 치 

여 기서 는 Eclipse 를 Linux 환경 에 설 치하는 방법 을 설명한다. 우리 식 조작체 계를 
리용할 때에는 Ecipse 3.0 을 우리 식 조작체계용으로 개작한 《 어깨동무》 1.2 판 
(《 Companion 》)을 쓴다. 일부 끼워 넣기는 Windows 판본에만 있다. 

• 필요한 파일 

Eclipse 를 동작시키 려면 다음과 같은 쏘프트웨어들이 필요하다. 

• JDK vl .6.0 의 JRE 또는 SDK (Software development kit ) 

• Eclipse 3.0 SDK 

• J 2 SE 의 설치 

Eclipse 3.0 의 실행을 하자면 JDK vl .6.0 의 Java 실행환경이 필요하다. 그러나 실지로 
Java 개발을 진행하려면 Java 실행환경만이 아니라 SDK 도 있으면 편리하다. 여기서는 
Jdk -6_0- ea - bin - bl 3- linux - i 586_18_ nov _2004- rpm ^ SDK 를 설치한다. 

• Eclipse - SDK 의 설치 

다음으로 Eclipse - SDK 를 설 치한다. 설치는 압축된 파일을 풀기 만하면 된다. 여 기 
서는 《/ kut / eclipse 》 에 Eclipse 본체파일이 설치된것으로 약속한다. 우리 식 조작체계 
에서 《어깨동무》 1.2 판을 리용할 때에는 《/ Companero -1.2》 에 설치된다. 

• 언어 꾸러 미 (Language Pack ) 의 설 치 

Eclipse 3.0 에 는 “Language Pack ” 라고 하는 여 러 나라 언어 대 응을 위 한 모둘이 제 
공되여 있다. Eclipse - SDK 자체는 영 어 에만 대응되 여 있으나 언어꾸러미를 도입함으로써 
지역화정보에 따라서 각 민족어로 차림표나 도움말 등이 표시되게 된다. 언어꾸러미의 
설 치도 Eclipse 와 마찬가지 로 압축파일을 풀기 만하면 된다. 여 기서 주의할 점 은 언어꾸 
러미를 설치하기 전에는 Eclipse 를 기동하지 말아야 한다는것이다. 언어꾸러미의 도입 
전에 Eclipse 를 기동하면 영 어방식 에서의 설정 파일 이 작성되 여 언어꾸러미를 적 용한 후 
에도 설정의 일부가 영 어방식으로 남아있으면서 일부 차림표나 서체의 설정 이 영 어로 되 
여있는 경우가 있다. 

• 기동지름아이콘의 작성 

( / kut / eclipse/eclipse (또는 / Companero -1. 2/ companero ) } 를 실 행 하면 
Eclipse 를 기동할수 있으나 기동의 편리 를 위하여 탁상에 지 름아이 콘을 만들기 로 한다. 
《 / kut / eclipse / eclipse ( 또는 / Companero -1.2/ companero ) 》의 지름아이론을 탁상 
에 작성하고 지름아이콘이름을 Eclipse 3.0 등으로 한다. 이상으로 설치는 완료되였다. 
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• Eclipse 의 기동과 서류철구성 

탁상에 작성한 Eclipse 의 지 름건을 기 동하면 작업 공간을 지 정하는 화면 이 나온다. 
작업공간등록부는 기정 으로《 [ Eclipse 의 서류철]/ workspace 》 로 되 여 있으나 관리 하기 
좋게 《/ kut / workspace ( 또는 / Companero -1.2/ workspace ) 》로 지정 한다(그림 1_5). 
여기서 《Use this as the default and do not ask again (이 선택을 기정으로 사용하 
고 앞으로는 이 질 문이 나타나지 않는다. )》검 사칸을 선택하면 다음번부터 는 이 대 화칸은 
나타나지 않게 된다. 만일 기동할 때 마다 작업공간을 지정 하고싶을 때 에는 선택하지 않 
고 [ OK ] 단추를 찰칵하면 된 다. 

Select a workspace 

片 clipse Platform stores your projects in a directory called a workspace. 

Select the workspace directory to use for this session. 

Workspace: |/Companero-1.2/workspace f^l Browse... 


□ Use this as the default and do not ask again 


OK 


Cancel 


그림 1-5. 작업공간등록부의 선택 

Eclipse 를 설치한 후 처음으로 기동할 때 에는 그림 1_6과 같이 [ Welcome ] 화면이 
나타난다. 
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그림 1-6. 첫 기동할 때 Welcome 화면 

錢變繼 錢變變繼繼繼 




























‘제 Mh Eclipse 多 ! 게요 


이 화면에서 매개 차림표의 내용은 아래와 같다. 


표 1-3. 

Eclipse 의 기동차림표 


차림표 

내 용 


Overview 

작업 공간의 기 본， Java 개 발，조지 원， Eclipse 끼 워 넣 기 개 발을 위 한 
도움말에 로의 련결 (link) 을 할수 있 다. 

Tutorial 

Java 개발， Java Applet 개발， SWT 응용프로그람개발， 
발，특성 정 보의 갱 신거 점 에 로의 배 치 (deploy) 에 관한 
가 있다. 

끼워 넣기 개 
개별지도서 

Samples 

SWT 의 견본，작업공간에로의 통합코드견본이 있다. 


What’s New 

Eclipse 에 관한 새로운 정보나 이전 판본으로부터의 이행， Eclipse 
의 갱 신을 진행할수 있는 차림 표가 있 다. 

Workbench 

Eclipse 의 기 본작업 환경 으로 이 행할수 있 다. 



Eclipse 를 리 용하여 개 발을 시 작하려 면 화면의 오른쪽우의 화살표식(작업 공간)을 
선택한다. 그러면 그림 1-7 과 같은 화면이 나타난다. Eclipse 설치후 첫 기동할 때에만 
그림 1-6 과 같은 Welcome 화면이 나타난다. 만일 이 초기화면을 다시 현시하려 한다면 
차림표의 [Help] ᅳ [Welcome] 을 리용하여 실현할수 있다. 



그림 1-7. Eclipse 창문 

지금까지의 공정으로 《 /root 》 이하의 서류철은 그림 1-8 과 같이 되여있다. 
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그림 1-8. 설치후 서류철의 내용 
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제2장. Eclipse 가동기반 

Eclipse 는 끼워넣기를 써서 여러가지 목적을 실현하는 도구이다. 이 장에서는 
Eclipse 가동기반이 가지고있는 가장 기본적이며 공통적 인 기능과 환경에 대하여 설명한다. 

제1절. Eclipse 의 기본조작 

Eclipse 를 기동하면 그 창문우에는 여 러 가지 화면부품이 표시된다. 또한 그 겉모양 
은 사용자가 쓰고싶어하는 환경 으로 변화시 킬수 있다. 여 기서는 Eclipse 의 기 본적 인 기 
능과 조작방법 에 대 하여 취 급한다. 

2.1.1. 작업대와 투시 

Eclipse 는 개발자에게 작업대 ( Workbench ) 를 제공한다. 이것은 Linux , 
Windows , Mac OS 등의 조작체 계 와 같은 관점 에서 고찰하면 된다. 조작체 계는 그자체 
로서 는 구체 적 인 작업 을 할수 없 다. 우리 는 조작체 계 우에 목적 에 맞는 응용쏘프트웨어 를 
설 치 하고 사용하여 야 한다. 마찬가지 로 개 발자도 개 발환경 을 작업 대 우에 전개하여 개 발 
을 진행한다. 바로 이것 이 Eclipse 상에서 여 러가지 개발을 수행 할수 있는 리유이다. 기동되 
면 창문이 나타나는데 이것을 작업대창 (Workbench window ) 이라고 부른다(그림 2-1). 

^一上【22^2^3:드^^^^^^^^^^^^^^^드고고^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^고<4-| 

■■■■■■■■■노■■■■노- Ar 

• ，‘， - 림 

B 


그림 2-1. 작업대와 그 우에 표시된 [ Resource ] 투시 
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작업 대 에 나타나는 환경 은《 투시 ( Perspective ) 》라고 부르는 단위 로 관리 한다. 개 
발을 진행 할 때에는 여 러개의 투시를 열수 있다. 설치직후에는 [ Resource ] 라는 투시 가 
표시된다. 이외 에도 표준장비되 여 있는 투시 (표 2-1 참고)가 있기때문에 개 발자는 목적 에 
맞게 투시를 절환하여 보다 효률적으로 작업을 진행할수 있다. 또한 끼워넣기도구 ([2. 4 
끼워넣기의 설치]참조)에 의하여 투시를 추가할수도 있다. 외부끼워넣기를 사용함으로써 
종래의 개 발환경과는 달리 Eclipse 에서는 단일한 쏘프트웨 어 ( Eclipse ) 상에 여 러 개의 개 
발환경을 갖추는것도 가능하게 되였다. 이렇게 함으로써 개발환경이 달라질 때마다 도구 
의 사용법을 다시 배우는것과 같은 복잡한 공정을 없앨수 있다. 


표 2-1. 


표준투시일람 


투시 명 


설 명 


CVS Repository Exploring 
Java 

Java Browsing 

Java Type Hierarchy 
Team Synchronizing 
Debug 

Plug-in Development 
Resource 


CVS 의 보관고관리 를 진행한다. 

Java 개 발을 진행한다. 

Java 의 클라스 및 패키지구성을 확인하면서 Java 의 
개발과 관리를 진행한다. 

Java 형 의 계 층검 색 을 진행한다. 

림 개 발에서 원천동기 를 맞추는 작업 을 진행한다 

Java 의 국부오유수정，원격오유수정를 진행한다. 

끼워넣기 개 발을 진행 한다. 

원천 파일 등 자원관리 를 진행한다. 


이제부터 실지로 현재의 투시(설치직후이면 자원투시)로부터 다른 투시(여기서는 
Java 투시)로 절환해보기로 한다. 

차림 표띠 에 서 [ Window ] [Open Perspective ] [ Other ] 를 선택 하여 투시 일 람표를 
현시한다. 여기에는 표준으로 설정되여있는 투시일람이 있다(그림 2-2). 그 일람에서 
[ Java ] 를 선택하고 [ OK ] 를 찰칵한다. 작업대창의 현시내용이 갱신되고 Java 투시가 작업대 
우에 전개된다(그림 2-3). 다시 [ Resource ] 투시로 되돌리려면 오른쪽우에 있는 투시절환 
도구단추를 찰칵한다. 
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그림 2-2. 투시의 선택 
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그림 2-3. Java 투시 
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2.1.2. 보기 (view ) 와 편집 기 

투시는 여 러개의 보기 와 편집 기 로 구성되 여있다(그림 2-4). 보기 란 Windows 의 열 
람기처럼 파일이나 패키지의 계층구조，오유수정중의 정보，능동상태에서 편집기의 속성 
( property ) 을 표시한것 을 말한다. 초기 화면의 자원투시 에 표시 되 는 [ navigator ] 나 
[ task ] 등이 여기에 해 당된다. 표 2-2 는 많이 쓰이는 대표적 인 보기의 일 람이다. 보기 
의 종류는 표 2-2 외에도 수많이 있으나 그것을 다 외워둘 필요는 없다. 그 리유는 매개 
투시가 최소한 필요하다고 보는 보기를 표준장비하고있기때문이다. 만일 부족되는 보기 
가 있을 때에는 개별적으로 투시에 추가할수 있다. 



편 a 기 


보기 


그림 2-4. 보기와 편집기 


표 2-2. 


보기 일람 


보기 명 


설 명 


Ant 

Bookmark 

Navigator 

Outline 

Property 

Synchronizing 

Task 


build , xml 의 속성 을 현시하며 Ant 를 실 행한다. 

작성한 책 갈피 를 현시한다. 

작업 대안의 자원의 계 층구조를 현시한다. 

클라스 의 마당 ( field ) 이 나 메 쏘드 ( method ) 를 현시한다. 

편집 기 에 열 려 져 있는 자원의 속성이 름과 값 등을 현시한다. 
CVS 보관고와 국부자원의 변경정보나 동기처리내용을 표시한다. 
콤파일오유나 TODO 목록을 나타낸다. 
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편집 기 에 서 는 자원의 현시 와 편집 을 진행한다. Java 파일 이 나 Ant 의 build , xml 파일 
에 대 하여 서 는 표준으로 편집 기 가 붙어 있 어 서 예 약어 를 강조문자로 표시하며 오유가 있 
는 경우 빨간 파도선으로 오유위 치를 표시하여준다. 

매 투시마다 보기와 편집 기의 구성 이 설정되 여있는데 새 로 보기를 추가하거 나 현재 
설정되여있는 보기를 현시하지 않도륵 하는것과같은 투시의 전용화를 진행할수 있다. 례 
를 들어 자원투시 안의 [ Ant ] 보기 를 현시 하려 면 차림 표띠 에 서 [ Window ] ᅳ [Show 
View ] 구 [ Ant ] 를 선택한다(그림 2-5). 



그림 2-5. Ant 보기의 현시 

또한 보기의 현시방법으로서 필요할 때에만 현시하게 하는 고속보기가 있다. 이것은 
보통 보기 와는 달리 단추화된 비 표시 보기이 므로 작업 대 의 공간을 차지하지 않는다. 이 것 
은 보기를 많이 리용하면서도 작업령역을 확보하려고할 때 효과적인 방법이다. 

고속보기 의 작성 방법 은 고속보기 로 하려 고하는 보기 의 제 목띠 에 서 마우스오른쪽단추 
를 찰칵하면 나타나는 차림표(이 차림표를 지름차림표라고 한다.)의 [Fast View ] 를 선 
택한다. 그러 면 창문아래 쪽에 고속보기단추가 나타나고 보기 가 비 표시 로 된다. 이 단추 
를 찰칵하면 해당보기가 일시적으로 표시되게 된다. 
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고속보기단추 

그림 2-6. 도구띠 

• 투시절환도구 

투시절환도구는 현재 열 려있는 투시 를 간단히 절환하기 위한 도구띠 이다. 작업 대창 
의 오른쪽우에 표시된다. 투시를 열 때마다 단추의 아이콘이 추가되고 투시를 담으면 없 
어진다. 

• 고속보기단추 

고속보기를 실현할수 있는 단추이 다. 고속보기단추는 창문의 왼쪽，아래，오른쪽중 
의 어느 하나로 이동될수 있다. 
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2.1.3. 도구띠와 단추 

투시 나 그 안에 있는 보기，편집 기 의 기 능을 리 용하거 나 최 량화하기 위하여 도구띠 
와 단추를 리용한다. Eclipse 에는 아래와 같은 도구띠와 단추가 있다(그림 2-6). 

• 주요도구띠 (main tool bar ) 

이것은 작업대창의 웃쪽에 있는 차림 표띠의 바로 아래 에 표시되는 도구띠 이다. 새로 
운 프로젝트의 작성 이나 보관과 같은 Eclipse 의 기본기능과 프로그람의 실행 등을 할수 
있다. 이 도구띠는 투시단위 로 설정된다. 또한 단추의 구분부분을 끌어놓기하여 배 치를 
바물수도 있다. 

• 보기 도구띠 (view tool bar ) 

매 개 보기 의 기 능을 리 용하기 위한 도구띠 이다. 매 개 보기 의 제 목띠 에 표시 되 여있 다. 
아이콘이 나 [▼] 으로 표시 되 는 차림 표로부터 보기 의 현시 설정 을 변경할수 있 다. 


투시절환도구 보기도구 (II 



주요도구띠 
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2.1.4. 화면의 전용화 

제한된 화면치수나 해상도의 조건에서 개발을 하려고할 때 개발자자신이 요구하는 
화면환경 으로 바물수 있다. Eclipse 에서 는 투시안의 보기종류나 현시위 치，크기를 변경 
하거 나 단추，차림 표를 변경하는 등 개 발자에 게 있어 서 가장 적 합한 환경 을 구비할수 있 
도륵 투시를 전용화할수 있다. 

• 보기의 재배치 

재배 치는 마우스로 보기의 제목띠를 끌어놓기하면 된다. 보기의 끌기를 시 작하면 놓 
기유표가 표시된다. 놓기유표가 표시되였을 때 단추를 놓으면 그 형태에 따라 표 2-3 에 
서 서술한 동작이 일어난다. 또한 보기의 크기 변경도 가능한데 그 경우 린접한 보기들의 
크기도 동적으로 변화된다는데 주의해야 한다. Eclipse3.0 부터는 창문밖으로 끌어놓기 
함으로써 편집 기밖에 독립 적 으로 보기창문을 현시하는것 도 가능하다. 


표 2-3. 놓기유표일람 


■기유표 설 명 


t (우로 이동) 보기의 제목띠를 선택한 상태에서 우로 끌면 이 유표가 현시 

된다. 이때 눌렀던 단추를 놓으면 보기창은 원래 자리의 웃쪽 
에 배치된다. 


1 (아래로 이동) 


— (오른쪽으로 이동) 


— (왼쪽으로 이동) 

면 (겹처서 현시) 

H (보기의 독립화) 
Q (떨구기금지) 


보기의 제목띠를 선택한 상태에서 아래로 끌면 이 유표가 현 
시된다. 이때 눌렀던 단추를 놓으면 보기창은 원래 자리의 아 
래 쪽에 배치된다. 

보기의 제목띠를 선택한 상태에서 오른쪽으로 끌면 이 유표가 
현시된다. 이때 눌렀던 단추를 놓으면 보기창은 원래 자리의 
오른쪽에 배치된다. 

보기의 제목띠를 선택한 상태에서 왼쪽으로 끌면 이 유표가 
현시된다. 이때 눌렀던 단추를 놓으면 보기창은 원래 자리의 
왼쪽에 배치된다. 

배 치 하려는 자리 에 있는 보기창의 내부로 끌기하면 이 유표가 
현시된다. 이때 눌렀던 단추를 놓으면 현재 위치에 있던 보기 
창의 안쪽에 이동되여 온 보기창이 태브표시로서 배치된다. 

배 치하려는 보기를 창문으부터 독립적으로 표시한다. 

편집기상이나 배치불가능한 자리에서 표시되며 이 표시중에 
단추를 놓아도 보기는 이동하지 않는다. 


보기의 오른쪽우에 있는 최소화단추를 찰칵하면 보기를 접어서 표시한다. 또한 최대 
화단추를 찰칵하면 보기가 투시전체에 표시된다(그림 2-7). 

편집기도 보기와 마찬가지로 끌어놓기로 편집기령역을 여 러개로 분할할수 있다. 그 
러나 편집기전체의 령역은 보기의 배치에 의존하여 현시위치나 령역의 넓이가 변하기때 
문에 보기의 재배치를 진행할 때에는 편집기의 령역을 고려할 필요가 있다. 
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그림 2-7. 보기의 최소화，편집기의 재배치 


• 투시의 전용화 

현재 의 투시 에 사용자에 게 편리한 새 로운 기 능을 추가할수 있다. 차림 표띠 의 
[ Window ] —[Customize Perspective ] 를 선택 하면 그림 2-8 이 나타난다. 

Shortcuts 태 브에 서 는 부분차림 표나 지 름건차림 표에 표시하는 항목을 전용화할수 있 
다. Commands 태 브에 서 는 차림 표띠 의 항목이 나 도구띠 단추의 유무를 전용화할수 있 다. 
이 리 한 설정내 용은 투시 별로 보존된다. 



그림 2-8. 투시의 전용화 
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보기의 려고}기기능 

[Package Explorer] 보기 나 [Navigator] 보기 에는 프로젝트정보가 있 다. 특히 
Java 개 발에 서 사용하는 [Package Explorer] 보기 에 는 사용하는 서 고파일 (*.jar) 이 
나 Java 의 원천파일뿐만아니라 다른 파일들도 현시되기때문에 서고파일을 많이 사 
용할 때 보기 힘들어지는 경우가 있다. 이려한 경우에 보기의 차림표에 있는 
[Filter] 를 리 용하는것 이 좋다. 이 기능에 의하여 지정한 조건을 만족하는 파일만을 
보기 에 현시할수 있다. 그림 2_9 는 [Package Explorer] 보기 의 려 과기 설정 화면 이 
다. 검 사칸을 선택 함으로써 원하는 파일 만을 표시할수 있 다. 



□ Name filter patterns (matching names will be hidden): 



0 / files 

□ Closed projects 

□ Empty packages 

0 Empty parent packages 

□ Fields 

0 Import declarations 
0 Inner class files 

□ Java files 

□ Local types 

□ Non-Java elements 

□ Non-Java projects 
Filter description: 


Select All | [ Deselect All 



| OK | | CanceT 


그림 2-9. Java 요소려과기 
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제2절. 환경설정 

편집기의 서체나 건반의 설정 등 Eclipse 의 환경설정은 차림표띠의 [Window] 
ᅳ [Preferences] 을 선택 하여 현시 되 는 대 화칸에 서 진행할수 있 다. 이 대 화칸에서 는 작 
업대의 설정， Java 나 Ant, 도움말 등의 설정도 할수 있다. 여기서는 작업대와 Java 개 
발을 위한 주요한 설정 에 대 하여 설명한다. 

2.2.1. JRE 의 정의 추가와 기정 JRE 의 설정 

Eclipse 에서는 Java 프로그람의 작성이나 실행에 사용하는 Java 실행환경을 여러개 
등록해 놓고 프로젝 트의 속성 이 나 기 동구성 에 서 지 정 함으로써 각이한 Java 실 행 환경 을 사 
용할수 있다. 여 기서 는 제 1 장에서 설명한 SDK 에 포함되는 JRE 를 기정 JRE 로 설정하 
는 방법 에 대 하여 설 명한다. 

우선 JRE 의 정의를 Eclipse 에 추가한다. 설정순서는 다음과 같다. 

1. 차림 표띠 의 [Window] —[Preferences] 을 선택 한다. 

2. 대화칸의 왼쪽에서 [Java] 세 nstalled JREs] 를 선택한다(그림 2-10). 



그림 2-10. JRE 의 설정대화칸 

3. 대 화칸의 오른쪽에 서 [Add] 단추를 찰칵한다. 

4. 이때 현시되는 대화칸의 [JRE type] 에서 《Standard VM》 을 선택하고 [JRE 
name] 에 ( jdkl .6.0》, [JRE home directory] 에 《 / Companero-1.2 / jdkl.6.0}(SDK 
를 설치 한 경 로)를 입 력 한다. 또한 [Use default sytem libraries] 검사칸을 선택 한다. 
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그러면 [JRE home directory:] 에 입 력된 경 로에 JRE 가 설치되 여있는가를 검사하고 자 
동적으로 Javadoc URL 의 설정과 JRE 체계서고의 jar 파일의 설정이 지정된다(그림 
2 - 11 ). 


JRE name: [ 石1!>_【:1【♦: | 

JRE home directory: | /Companero-1.2 신 dkl.6.0 | |_Browse..> 

Javadoc URL: Browse... 


Default VM Arguments: 

JRE system libraries: 

0 Use default system libraries 


출 irt.jar - /Companero-1.2/jdkl.6.Q(jre/lib/ 

三 

1 □ 

호 jsse.jar - /Companero-1.2^jdkl.6.(Vjre/lih/ 



i^jce.jar - /Companero-1.2/idkl.6.(Vjre/lib/ 



仏 charsets.jar - /Compan€ro-1.2/jdkl.6.0/j re/lib/ 


1 1 

£ sunpkcsll.jar - /Companero-1.2/jdkl.6.(yjre/liWext/ 



m sunjce 一 pravider.jar - /Companero-1.2^jdkl.6.(Vjre/lilVext/ 



£ dnsns.jar • /Companero-1.2/jdkl.6.0/jre/lib/ext/ 

V 

1 1 


그림 2-11. JRE 의 작성대화칸 

5. [OK] 단추를 찰칵하여 대화칸을 담으면 이미 설치되 여있는 JRE 의 일 람에 새 로운 
JRE 의 정의가 추가된다. 

이 상으로 JRE 의 정의 가 작성되 였고 계 속하여 기정 JRE 에 대 한 변경 을 진행한다. 

1. 대화칸의 [Installed JREs] 에서 앞서 등록한 [jdkl.6.()] 검사칸을 선택한다. 

2. 대 화칸의 [OK] 단추를 찰칵한다. 

3. 변경을 유효로 하기 위한 확인대화칸이 표시되는데 [Yes] 단추를 찰칵한다. 

개발대상의 JDK 판본이 하나일 때에는 JRE 의 변경은 특별히 필요없다. 그러나 콤 
퓨터의 환경에 따라서는 JRE 만 있는 서류철에 기정 JRE 가 지정되는 경우도 있다. 이리 
한 상태에서도 개발을 진행할수는 있으나 SDK 에 포함되는 원천코드가 추가되지 않는다. 
우에서 보는바와 같이 SDK 에 포함된 JRE 로 변경하면 SDK 와 함께 배 포되 여있는 원천 
코드가 추가되기때문에 JRE 체계서고의 원천코드를 참조할수 있게 된다. 

JRE 의 원천코드는 Java 개 발자들이 직 접 쓴것 들이 기 때 문에 코드분석 을 위한 리 상적 
인 교재 라고 할수 있다. SDK 를 설치 하고있다면 여 기서 설명한 절차를 따라 기정 JRE 를 
변경하는것 이 좋다. 
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2.2.2. 기동할 때 추가선택에 의한 환경설정 

Eclipse 를 기동할 때 에 추가선택 을 진행 함으로써 여 러 가지 설정 을 변경할수 있다. 
례를 들어 작업공간등록부는 보통 Eclipse 를 기동할 때 에 작업공간설정대화칸에서 설정 
한다(그림 2-12). 

— | x| 

Select a workspace 

Eclipse Platform stores your projects in a directory called a workspace. 

Select the workspace directory to use for this session. 


Workspace: /Companero-1.2/workspace 


四 Browse... 


□ Use this as the default and do not ask again 


그림 2-12. 작업공간의 선택 

기동할 때 작업공간의 선택은 한번 지정하면 기억된다. 설정정보는 《 / kut / 
eclipse / configuration / org . eclipse , ui . ide / recent / Workspaces . xml } 에 기 록된다. 
기 동할 때 의 작업 공간설 정 대 화칸에 서 [Use this as the default and do not ask again ] 
검 사칸을 선택하면 작업 공간설정 대 화칸이 표시 되지 않으며 recentWorkspaces . xml 파 
일안의 《alwaysAsk showDialog : “0” /》에서 《0》을《1》로 설정하여 다시 작업 
공간설정 대 화칸을 현시할수 있 다. 

작업공간등록부의 지정은 Eclipse 의 실행파일인수에 《- data 》 를 지정하는 방법으로 
도 가능하다. 

이 책에서 취급하는 작업공간등록부로는 우에서 설정한《 / kut / workspace 》 를 사 
용하고 제 3장이 후에 작성하는 견본코드 ( Java 파일， xml 파일 등)는 모두 《 / kut / 
workspace 》 아래 에 작성 할것 을 전제 로 한다. 

/ kut / eclipse/eclipse - data 〈설정 하는 작업공간등록부의 경로〉 

Eclipse 의 실행 에 쓰이는 가상기 계는 환경변수의 Path 로부터 자동적 으로 검 색되지 
만 다른 가상기계가 지정되여있어서 제대로 기동되지 않았거나 여 러가지 가상기계를 엇 
바꾸어 쓰고싶을 때 는 다음과 같은 방법 으로 가상기 계 를 지 정할수 있 다. 

/ kut / eclipse/eclipse _vm < VM 의 실행파일〉 

또한 Eclipse 의 실행 에 쓰이는 VM 의 인수를 리용하고싶을 때는 《- vmargs 》 를 지 
정한다. 대규모응용프로그람이 나 여 러개의 프로젝트를 동시 에 개 발하려 고할 때는 기 억 기 
크기 를 늘여 서 실 행하는것 이 좋다. 

/ kut / eclipse/eclipse -vmargs < VM 의 인수를 서술〉 

Eclipse 의 실행시간고속완충자료를 지우기 위해서는 《- clean 》 을 지정한다. 새로운 
끼워넣기를 넣었을 때나 작업공간의 파일을 강제적으로 복사했을 때 비정상적인 현상이 
일어난 경우 이것을 리용하면 개선될수 있다. 《- clean 》 을 지정하면 실행시간작업대의 모 


30 錢變繼錢變變繼繼繼 














세 2 강 . Eclipse 가 4 ■기 •욘 


든 실행시간고속완중자료가 기동할 때마다 지워지고 작업대에서 진행된 모든 변경이 실 
행시간작업대가 기동할 때에 반영되게 된다. 그대신 끼워넣기를 많이 포함하는 경우에 
기동할 때의 성능이 낮아질수 있다. 

/ kut / eclipse/eclipse -clean 

다른 인수에 대한 설명은 도움말의 [Workbench User Guid ] — [ Task ] — 
[Running Eclipse ] 에 있다. 

또한 clean 인수에 대하여서는 도움말의 [PDE Guide ] ^ [ Reference ] ^ [Tips and 
tricks ] 에 있다. 

• Eclipse 를 기동시켰을 때 장애해결방법 

Eclipse 가 제대로 기동하지 않는 가장 많은 경우가 여러개의 가상기계가 설치되여 
있는 환경 에서 Eclipse 의 기동에 쓰이는 가상기 계 가 대 응되 여있지 않은 경 우이 다. 례 하 
면 JRE 1.3.1 과 JRE 1.4.2 가 설치되여있는 환경 에서 Eclipse 의 기동에 JRE 1.3.1 을 

리 용하면 《An Error has occurred . . (오유가 발생 하였습니 다. .) } 등의 통보 

문이 현시되면서 기동하지 않는다. 이러한 경우에는 기동추가선택을 써서 명시적으로 리 
용할 가상기계를 지정 하면 해결된다. 구체적으로는 기동추가선택에 《 -vm 
/ usr / java / jdk / jre / bin / java 》 로 지정하여주면 된다. 

2.2.3. 작업대의 환경설정 

작업 대 나 매 개 투시 의 환경 설정 은 차림 표의 [ Window ] ᅳ [ Preferences ] 을 선택하 
면 그림 2-13 과 같은 설정 대 화칸이 표시 되는데 여 기 에서 진행한다. 매 항목의 왼쪽에 
있는〉단추를 찰칵하면 상세 한 설정 항목이 전개된다. 표 2-4 에서 Preferences 대 화칸 
의 항목과 설정 내 용을 보여 주었 다. 설정 파일은 [ import ] , [ export ] 단추를 리 용하여 읽 
어 들이고 보존할수 있 다. 

■豆] 호] 

Workbench 

□ Always run in background 
0 Build automatically 
「1 Refresh workspace automatically 

□ Save automatically before build 

□ Keep next/previous part dialog open 

Workspace save interval (in minutes): 15 


Build Order 
Help 

Install/Update 

Java 

Run/Debug 


Open mode 
® Double click 
O Single click 


Note ： This preference may not take effect on all views 


Restore Defaults 


Apply 


Import... 


Export … 



그림 2-13. 설정대화칸 
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표 2-4. 

설정항목과 설정내용 


항목명 

설정내용 


Workbench 

Ant 

Java 

Install/Update 

Team 

Build Order 

Help 

Run/Debug 

본문편집기，투시，서체，건 (key) 등의 설정 

Ant 편집기 (build.xml), 실행시 클라스경로의 설정 

Java 편집기，코드형식화기， JUnit 등의 설정 

갱신할 때 대 리 (proxy) 의 설정，자동갱신의 설정 등 

CVS, 파일내용물 등의 조기능설정 

프로젝트건립순서의 설정 

도움말열람기의 설정，도움말봉사기의 포구설정 등 

조종탁 (console), 보기관리，기동 등 실행 및 오유수정기능의 설정 


여기서는 작업대에 관한 기본설정에 대하여 소개한다. 

• Workbench (작업대) 

작업대에 대한 기본적인 설정을 진행할수 있다(그림 2-14). 표준설정에서는 원천파 
일을 보존하면 동시 에 콤파일 이 진행되지 만 [Build automatically] 검사칸을 선택하지 
않으면 수동으로 콤파일을 진행해 야 한다. 




>； flltfhf 卽 

」 Bpritsh mDtksEUce 4ut«niu»ciiy 
H iuefniBca^ Mid 
n 폐 /， WlTUi pirt cftJkBg open 


보切 rt 比 : PMC mlv_ irmrvjd 由 n mi_cs ； i; 5 



][ 


그림 2-14. 작업대의 설정 

• Editors (편집기) 

편집기의 부호화지정이나 편집기안의 행번호표시，편집기안의 문자표시색의 설정 등 
을 할수 있다(그림 2-15) . 본문편집기의 항목에 있는 [Show line numbers] 검사칸을 
선택하면 편집 기 의 왼쪽에 행 번호가 표시 된다. 
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그림 2-15. 본문편집기의 설정 

• Appearance (겉 모 양) 

편집기의 태브위치에 대한 설정을 할수 있다(그림 2-16). 례하면 편집기태브는 표 
준으로는 웃쪽에 표시되지 만 [Editor tab positions ] 나 [View tab positions ] 의 선택 표 
시를 Bottom (아래쪽)으로 바꾸면 태브의 위치가 아래쪽으로 이동한다. 



그림 2-16. 겉모양의 설정 


• Colors and Fonts (색과 서체) 

대화칸이나 보기，편집기의 색과 서체를 지정할수 있다(그림 2-17). [Colors and 
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Fonts ] 에 검 색 문자를 입 력하거 나 아래 의 목록에 서 대 상으로 되 는 설 정 항목을 골라서 
[ Change ] 단추를 찰칵하면 설정대화칸이 표시된다. 대화칸에서 필요한 서체를 선택할수 
있 다. 



그림 2-17. 색과 서체설정 


• Keys (건) 

건반에 관한 설정 을 할수 있다. 표준으로는 《 Default 》 와 《 Emacs 》 으로 되 여있다. 
또한 건에 대한 전용설정을 하자면 그림 2-18 과 같이 하면 된다. [ Command ] 에서 
추가 또는 변경 하려 는 범 주 ( category ) ， 이 름， 할당을 선택 하여 아래 단의 [key 
sequence ] 에 서 건의 할당을 추가 또는 삭제한다. [ Add ] 단추를 찰칵하면 웃단의 
[ Assignments ] 에 추가된다. [ Apply ] 를 찰칵하면 설정이 반영된다. 

개발자에게는 건반작업에서 지름건은 필수적이기때문에 자기의 작업상 편리를 고려 
하여 전용화하는것이 좋다. 
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텔 HW8M 


， Workbench 
Appearance 
Capabilities 
Colors and Fonts 
Compare/Patch 
▽ Editors 

Annotations 
Quick Diff 
Text Editor 
File Associations 


J Decorations 
Linked Resources 
Local History 
Perspectives 
Search 

Startup and Shutdown 
!> Ant 

Build Order 


t> Install/Update 
I> Java 
> Run/Debug 
l> Team 


Keys 


151x1 

□ 


Keyboard Shortcuts [Advanced | 


Active configuration: , Default 


command 

Category: 

Compare | v | 

Name: 

Copy All from Left to Right 

四 

Assignments: I 

Iwhen 

|Key Sequence 




Key Sequence 
Name: 


囚 


When: | In Windows 


I v | (extends In Dialogs and Windows) 


Restore Defaults Apply 


Import... 


Export... 


그림 2-18. 건설정 


2 가지 설정 

Eclipse 에서 는 2가지 중요한 설정 을 진행 하여 야 한다. 

하나는 작업대 에 관한 설정 이 다. 이것은 JVM 나 끼워넣기도구，작업대의 전반 
적인 설정이고 작업공간단위로 관리된다. 

다른 하나는 프로젝트에 관한 설정 으로서 프로젝트의 속성 에서 진행할수 있다. 
여기서는 프로젝트단위로 리용하는 클라스경로나 콤파일 설정을 진행할수 있으며 그 내 
용은 매개 프로젝트등록부의 바로아래에 있는 . project , . classpa 仕 l 에 서술되여있다. 

Java 콤파일 러 나 과제 등의 설정 은 작업 대 나 프로젝 트에서 진행할수 있는데 량 
쪽 다 설정되 여있는 경우에는 프로젝트의 설정 이 우선권을 가전다. 프로젝트에서 설 
정하지 않는 경우에는 작업대에서의 설정이 적용된다. 
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제3절. 도움말의 사용법 

Eclipse 는 도움말기능이 풍부하여 Eclipse 의 기본적 인 안내서로부터 Eclipse 의 끼 
워넣기개 발에 관한 안내서에 이르기까지 폭넓은 정보를 제공한다. 또한 검색 이나 책갈피와 
같은 웨 브열 람기 의 기 능도 있 다. 여 기 서 는 도움말의 내 용과 그 기 능에 대 하여 설명 한다. 

2.3.1. 도움말열람기 

도움말열 람기를 보기 위 해서 는 차림 표띠 에서 [Help] —[Help Contents] 를 선택 한 
다. 그러면 Eclipse 와는 다른 창문에 도움말열람기가 현시된다(그림 2-19). 처음에 현 
시되는 보기를 도움말보기 (Help view) 라고 부론다. 도움말보기에서는 차례나 검색기능 
을 리 용하여 정 보를 검 색할수 있 다. 



그림 2-19. 도움말열람기 
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문맥 (context) 에 의존한 도움말의 리용 

Microsoft Office 등의 일반적인 Windows 응용제품들과 마찬가지로 F 1 건을 리 
용함으로써 필요한 정보를 재빨리 검색할수 있다. 이 경우 능동상태로 되여있는 기능 
에 대 응한 도움말이 현시 된다. 례하면 [Package Explorer ] 보기 에 관한 정 보를 알고 
싶을 때는 [Package Explorer ] 보기를 활성화(제목띠를 한번 찰칵)하고 F 1 건을 누 
르면 풍선도움말 ( balloon ) 이 현시된다. 거 기 에는 [Package Explorer ] 보기 에 관한 
도움말정 보가 표시 되 여있기때 문에 알고싶은 항목을 선택하면 된다. 이 와 같은 도움말 
기 능을 문맥 에 의 존한 도움말이라고 한다. 



j 令 ▼ O ，接 ▼ j 03 ® © ， . 食 夕 j •: 仁 


© | % J 3ava 


IfgE Outline 然 


그림 2-20 문맥에 의존한 도움말 


2.3.2. 내용물안내 

도움말열람기를 기동하면 왼쪽에는 내용물의 일람이 표시된다. 내용물에는 아래와 
같은것이 있다. 

• 작업대사용자지도서 

프로젝트의 작성절차，편집기나 보기의 사용법 등 Eclipse 의 기본적인 설명과 조작 
법이 서술되여있다. 개별지도서형식으로 되여있으므로 처음으로 Eclipse 를 쓰는 사람이 
라도 알기 쉬 운 내 용으로 되 여있 다. 쉽 게 기 본적 인 조작을 습득하는데 리 용할수 있 다. 
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• Java 개발사용자지도서 

프로젝트작성으로부터 실행 및 오유수정까지의 일련의 Java 개발에서 리용하는 

Eclipse 의 Java 개 발도구 ( JDT ) 에 관한 정 보가 서 술되 여있 다. 

• 가동기 반끼 워 넣 기 개 발자안내 서 

Eclipse 가동기반에 관한 보다 핵심적인 정보를 제공한다. 례를 들어 Eclipse 의 개 
념과 내용에 대한 정보를 제공한다. 

• JDT 끼워넣 기 개 발자안내서 

JDT ( Java 개 발도구)의 끼워 넣기도구를 작성 하기 위 한 구체적 인 정보를 제공한다. 
Eclipse 에서 사용하고있는 JDT 의 내용을 API 의 소개와 함께 해설하고있다. 


• PDE 안내서 

끼 워 넣 기 개 발환경 ( Plug-in Development Environment ) 을 써 서 끼 워 넣 기 ([2. 4끼 
워넣기의 설치]를 참고)를 개발 및 작성할 때 필요한 정보를 제공한다. 

2.3.3. 도움말의 검색방법 

특정한 어휘나 항목에 대한 정보를 검색하려고할 때에는 도움말열람기의 검색기능을 
리 용한다. 열 람기 의 웃쪽에 있는 [ Search ] 부분에 검 색하려 는 단어 를 입 력 하고 
[ Search ] 단추를 찰칵하면 해 당한 정 보가 적 중률 (hit ratio ) 과 함께 왼쪽의 도움말보기 에 
표시된다(그림 2-21). 첫번째 검색때는 색인을 작성하기때문에 좀 시간이 걸리고 다음 
번부터 는 더 빨리 검 색할수 있 다. 



그림 2-21. 도움말의 검색 
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2.3.4. 조사한 정보를 책갈피에 추가 

한번 조사한 정보를 책갈피에 등록함으로써 자주 쓰이는 도움말정보로 설정해놓을수 
있 다. 열 람기 의 오른쪽우에 있는 [Bookmark Document ] 를 누르면 지 금 현시 되 여있는 
정 보가 책 갈피 에 등록된다. 그다음부터는 도움말보기의 [ Bookmark ] 단추로부터 정 보를 
얻을수 있다(그림 2-22). 



그림 2-22. 한번 조사한 정보를 책갈피에 추가 


제4절. 끼워널기의 설치 


2.4.1. 끼워넣기란 

끼워넣기 란 Eclipse 의 기능을 확장하기 위한 모둘이며 Eclipse 의 기능은 모두 끼워 
넣기에 의 하여 실현되고있 다. 례 하면 표준적인 Java 개발환경 ( JDT ) 이나 림 개발기능들도 
다 끼워넣기로 구성되 여있다. 또한 외부의 끼워넣 기를 설치 함으로써 C ++ 의 개 발환경을 
추가하거 나 UML 를 작성할수 있다. 끼워넣기의 개 발자체도 Eclipse 상에서 진행할수 있 
다. 끼워넣기개 발에 대해서는 아래장에 구체적으로 서술되 여있으며 여기서는 인터네트 
등에서 공개되 여있는 끼워 넣기의 설치 방법과 Eclipse 의 판본갱 신방법 에 대 하여 설명 한다. 

• 끼워넣기구성의 관리 

차림 표의 [ Help ] —[Software Updates ] —[Manage Configration ] 를 선택 하면 이 
미 설 치되 여있는 끼워넣 기의 구성관리를 진행하는 창문이 나타난다(그림 2-23). 
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그림 2-23. 끼워넣기구성의 관리 

왼쪽에는 Eclipse 가 설치되여있는 장소와 끼워넣기의 계층구조가 현시된다. 대상으로 
되는 끼워넣기를 선택하면 오른쪽에 판본 등의 자세한 정보가 표시된다. 이 정보안의 
[ Disable ] 를 찰칵하면 끼워넣기를 무효로 할수 있다. 사용하지 않는 끼워넣기를 무효로 
함으로써 Eclipse 의 기동과 동작을 가볍게 할수 있다. 또한 상세정보안의 [Scan for 
Updates ] 를 찰칵하면 망경유로 끼워넣기의 갱신거점과 접속하여 새 판본의 확인과 갱신 
을 할수 있다. 

• 설 치/갱 신조수에 의한 끼워넣 기도입 

새로 끼워넣기를 설치하는 방법에는 설치/갱신조수를 리용하는 방법이 있다. 이 방법 
은 끼워넣기의 갱신거점을 지정하기만 하면 망 또는 파일체계경유로 자동적으로 끼워넣기 
의 판본을 검사하고 끼워넣기를 내 리적재하여 설치할수 있다. 끼워넣기의 갱신거점 이 있 
으면 간단히 끼워 넣기를 설치할수 있다. 

여기서는 Easy Struts 의 Easy Explorer 끼워넣기의 설치를 실례들어 설명한다. 

설치/갱신조수를 기동시 키려면 [ Help ] —[Software Updates ] ^ [Find and 
Install ] 를 선택한다. 조수의 첫 화면에서 [Search for features to install ] 을 선택하고 
[ Next ] 단추를 찰칵한다. 그러면 [ Install ] 대화칸이 표시된다. 여기서 끼워넣기의 갱신거점을 
추가한다. [New Remote Site ] 단추를 찰칵하면 명칭과 URL 의 입력대화칸이 나오는데 여기서 
명 칭에 는《 Easy Struts 》， URL 에《 http :// easy struts , sourceforge . net / eclipse / updates / } 
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을 입 력 하고 [OK] 단추를 찰칵한다.〉를 찰칵하여 계 층구조를 전개하면 설정 이 정 확 
한 조건에서 거점으로부터 끼워넣기의 정보가 얻어지며 그림 2-24 와 같이 설치가능한 
끼워넣기의 일람이 현시된다. 여기서는 《Easy Explorer plugin》 을 선택하고 [Next] 
단추를 찰칵한다. 

【 3BS 日 !^ ■ 

Update sites to visit 

Select update sites to visit while looking for new features 

Sites to include in search: 

[y0^B Easy Struts 
r- --0^ EasyExploer pluyin 
卜 - •□ 매 Easy Struts plugin 
요 □ 견 Q Eclipse.org update site 


0 Ignore features not applicable to this environment 


^■ 레 초 ] 

정 3 



New Local Site.. 


New Archived Site.. 





그림 2-24. 끼워넣기의 설치 

다음 화면에서는 지정한 끼워넣기별 일 람이 표시된다. 이 안에서 설치하려는 끼워넣 
기 에 선택표시를 한다. 여 기서는 《Easy Explorer plugin》 의 《1.0.1》 을 선택 하고 
[Next] 단추를 찰칵한다. 다음 허 가사항이 표시 되 는데 [I accept the agreement] 를 선 
택하고 [Next] 단추를 찰칵한다. 

다음 화면에서 지정한 끼워넣기의 정보와 끼워넣기의 설치위치를 확인하고 
[Finish] 단추를 찰칵하면 끼워 넣기의 설치 가 시 작된다. 마지막으로 Eclipse 의 재기동을 
독촉하는 대화칸이 나오는데 [Yes] 단추를 찰칵하면 Eclipse 가 재기동된다(그림 2-25). 


Install/Update 


You will need to restart the workbench for the 
changes to take effect. Would you like to restart now? 




No 


그림 2-25. 설치후의 재기동대화칸 
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실지로 설치한 끼워넣 기를 리용해보기 로 한다. [ Navigator ] 보기 에서 파일 또는 등 
륵부를 선택한 다음 지 름차림 표를 열면 [Easy Explorer ] 항목이 있는것 을 알수 있 다. 
이것을 선택하면 선택되여있는 등록부가 열람기에 열린다. 이처럼 EasyExplorer 가 설 
치되여 기능이 추가된것을 확인할수 있다. 

이 와 같이 갱 신조수에 의한 설 치 에서는 URL 를 지 정 하고 화면에 따라 조작하기 만하 
면 간단히 끼워넣 기의 설치를 할수 있다. 또한 내 리적재한 끼워넣기파일 이 site.xml 를 
포함하고있을 때에는 설치대화칸의 [New Archive Site ] 또는 [New Local Site ] 에서 
자기 콤퓨터 의 파일 을 지 정하여 설 치할수도 있 다. 


대리봉사 ( proxy ) 를 경유하는 끼워넣기의 갱신 

기업내국부망에 접속되여 있고 대리봉사로 인터네트에 접근하는 환경에서는 끼워 
넣기갱신의 대리설정이 필요하다. 이리한 경우에는 차림표띠에서 [ Window ] ᅳ 
[ Preferences ] —[ Install / Update )] 을 선택하고 오른쪽에 현시되는 [Proxy 
settings ] 에 서 [Enable HTTP proxy connection ] 검 사칸을 선택 한다. 그리 고 
[HTTP proxy host address ] 에 는 대 리봉사기 의 IP 주소를 주고 [HTTP proxy 
host port ] 에 는 대 리봉사기 의 포구번 호를 설정한다(그림 2-26). 



그림 2-26. 대리봉사기의 설정 
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2.4.2. 수동설치방법 

갱신조수에 의한 설치외에 끼워넣기의 파일을 수동으로 복사하여 설치하는 방법이 
있다. 조수설치방법을 지원하지 않는 끼워넣기는 수동으로 설치한다. 여기서는 
eclipse . org 안의 Eclipse Tools Project 에서 개 발되 고있는 Visual Editor ( VE ) 끼 워 넣 
기 에 대 하여 설 명한다. 

수동설 치 방법 은 다음과 같은 순서 로 진행한다. 

1. Eclipse 가 기동되여있는 경우 일단 완료한다. 

2. eclipse.org 의 EMF 프로젝트 (http://www.eclipse.org/emf) 로부터 EMF, SDO 
의 실행 파일 (emf-sdo-runtime-2. 0.1. zip) 을 내 리 적재 한다 

3. 2에서 얻은 파일을 풀면 eclipse 라는 등록부아래에 feature 와 plugins 라는 등록 
부가 생긴다. feature 와 plugins 등록부를《 / eclipse 》 안으로 이동한다(보존파일 
을 직접 《/》아래에 덧쓰기방식으로 풀어도 된다). 

4. eclipse.org 의 GEF 프로젝트 (http://www.eclipse.org/emf) 로부터 GEF 의 실행 
파일 ( GEF - runtime-3.0.1. zip) 를 입수하고 3 . 에서처 럼 풀어서 생긴 feature 와 
plugins 등록부의 내용을 《 /eclipse 》 에 덧쓰기이동한다. 

5. eclipse.org 의 Visual Editor 프로젝트 (h 竹 p://www.eclipse.org/vep /) 로부 
터 Virtual Editor 의 실행파일 (VE-runtime-l. 0. zip) 를 입수하고 3 .에서처럼 
풀어서 생긴 feature 와 plugins 등록부의 내용을 《 /eclipse 》 에 덧쓰기이동한다. 

6. EMF, SDO, GEF, VE 의 언어패 키지 (Nlpack-emf-sdo-runtime_2. 0. 0. zip, 
Nlpack-GEF-runtime-3 . 0. 1. zip, Nlpack-VE-runtime-1. 0. x . zip) 파일을 입 
수하고 3 .에서처럼 풀어놓은 feature 와 plugins 등록부의 내용을 《 /eclipse 》 에 
덧 쓰기 이 동한다. 

7. Eclipse 를 재기동한다. 

등록부의 이름을 보면 알수 있는바와 같이 끼워넣기파일은 〈〈[ eclipse 가 있는 등록 
부]/ plugins / [끼워 넣기패 키지 이름]_<판본번호〉》라는 등록부에 놓인다. 마찬가지로 특 
성정보(끼워넣기를 모아놓은것)에 관한 파일들은 《 [eclipse 가 있는 등록 
부]/ features / [끼워 넣기패키지 이름]_<판본번호〉》라는 등록부에 놓인다. 끼워넣기와 특 
성정보의 설치는 해당등록부에 파일을 놓기만하면 끝난다. Eclipse 는 기동할 때에 새로 
운 끼워넣 기등록부가 있는가를 검사하고 파일 이 있으면 자동적 으로 끼워넣기 및 특성정 
보를 읽어 들인 다. 

VE 끼워넣기의 설치 가 성공하면 편집기 로 Visual Editor 가 추가된다. Swing 및 
SWT 의 도형 사용자대 면부요소의 파일 을 열 면 도형 적 으로 표시 및 편집할수 있 다(그림 
2-27). 
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4 불게방환경 Eclipse 



그림 2-27. Visual Edit 아에 의한 GUI 요소의 편집 


이전 끼워넣기와의 호환성 

Eclipse 3. 표와 Eclipse 2.x 사이 에서의 끼워넣기호환성은 완전히 보장되 여있지 
않다. 그러 나 기 본적 인 부분은 같기때문에 약간만 수정해도 되는 끼워넣 기도 많다. 
특히 간단한 기능의 끼워넣 기는 정식 으로 Eclipse 3.0 에 대 응되 여있지 않아도 움직 
이는 경우도 있다 (《Eclipse Explorer plugin 》 이 그러한 실례로 된다). 

Eclipse 2. 표에서는 JDK1.3 에 기초하고 XML 구문분석기 (parser) 가 JDK 에 
포함되 여있지 않으므로 SDK 의 내부에 org.apache.xerces 라는 끼워넣기 가 있었 
다. 그러나 eclipse3.0 부터는 JDK1.4 기반이므로 JDK 에 XML 구문분석기가 포함되 
여있어 xerces 끼워넣기는 생략되였다. 그 결과 xerces 끼워넣기를 리용하고있는것은 
그대로는 Eclipse 3.0 에서 쓸수 없다. 그러 나 아래와 같이 하면 Eclipse 2.x 끼워 넣 
기 가 높은 판본에서 동작하는 경우가 있다. 

1. Eclipse 3.0 의 plugins 등록부에 Eclipse 2.x 부터 org.apache.xerces_x.x.x 
의 등록부를 복사한다. 

2. 해당 끼워넣기의 plugin.xml 에 《 "〈import plugin="org. apache, xerces” 
/〉’’》가 존재하는 경 우에 는 삭제한다. 

이 방법 으로 x-men(ver. 0.4. 2. 3) 등이 동작할수 있게 된다. 


44 


錢變邊 錢變變繼繼繼 


























세 2 강 . Eclipse 가 4 ■기 •욘 


2.4.4. 끼워넣기의 판본갱신 

끼워 넣 기의 판본을 최 신으로 갱 신하자면 [ Help ] —[Software Updates ] —[Find 
and Install ] 를 선택하면 현시 되 는 대 화칸을 리 용한다. 조수의 첫 화면 에 서 [Search 
for updates of the currently installed features ] 을 선택 한다. 현재 설 치되 여 있는 끼 
워넣 기의 갱 신정 보를 검 색 하고 설치할수 있다. 끼워넣 기의 갱 신은 

[ Window ] — [ Preferences ][ Install / Update][Automatic Updates ] 을 통하여서 도 
할수 있다. 이와 같은 설정은 기동할 때에 혹은 일정한 간격으로 끼워넣기를 갱신할수 
있게 하여준다. 
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제 3 장 . Eclipse 에 의한 Java 프로그람작성 

제1절. 새로운 프로젝트와 클라스의 작성 

3.1.1. 견본프로그람의 개요 

3장에 서 는 간단한 견본프로젝 트를 작성하면서 Eclipse 상에 서 의 기 본적 인 개 발절 차 
에 대 하여 구체 적 으로 설명한다. 종업 원번호，이 름，전화번호，책 임 자에 관한 정 보를 표 
시 하는 Java 응용프로그람을 실례 들어 설명한다. 작성하려 는 견본프로그람의 클라스도를 
그림 3-1 에 주었다. 


작성한 콜라스대면부 



그림 3-1. 견본프로그람의 클라스도 

HelloEmployee 클라스에서 XML 파일을 지정하고 EmployeeMapFactory 클라스의 
구체례 ( instance ) 를 생성한다. 목록 3_1 에 읽어들일 XML 파일 employee.xml 에 대하 
여 서술하였다. 여기서 매 종업원들은 ID 값 (id 속성)을 가지며 이름 (name 요소)，직위 
(role 요소)，전화번호 (telNumber 요소)，책임자의 식별부호 (bossld 요소)를 가전다. 
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목록 3-1. _ employee.xml _ 

<?xml version : ‘1.0’ encoding : “ Shift _ JIS ” ?> 
< EmployeeList > 

〈Employee id = “01” > 

< name>kim kim </ name > 
< role > Manager </ role 〉 
< telNumber >3581111</ telNumber > 
< bossId /> 

〈/ Employee 〉 

〈Employee id = “02” > 

< name>Li kim </ name > 

< role > Designer </ role 〉 
< telNumber >3582222</ telNumber > 
< bossId 〉01< bossId /> 

〈/ Employee 〉 

〈Employee id = “03” > 

< name>Pak kim </ name > 
< role > Engineer </ role 〉 
< telNumber >3583333</ telNumber > 
< bossId 〉01< bossId /> 

〈/ Employee 〉 

</ EmployeeList > 


EmployeeMapFactory 에서 종업원속성을 표현하는 JavaBean 인 Employee 클라스 
의 구체 례 를 종업 원수만큼 작성하여 EmployeeMap 에 넣 는다. Employee 클라스의 실제 
개 수는 읽 어 들이 는 XML 파일 ( employee , xml ) 의 〈 employee 〉 요소개 수와 같다. 또한 
EmployeeMapFactory 에서는 XML 파일을 읽 어들이 기 위해 XmlUtil 클라스를 리용한다. 

EmployeeMap 와 Employee 클라스들은 모두 대면 DisplayObject 를 실현하고 대 
면에서 정 의된 display 메 쏘드를 리 용하여 표준입 력 에 의한 종업 원속성 을 출력한다. 

3장에서 는 HelloEmployee 클라스， Employee 클라스， DisplayObject 대면과 

employee , xml 파일 을 작성한다. 
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3.1.2. 프로젝트란 

Eclipse 로 Java 프로그람작성을 시작하기 전에 우선 프로젝트를 작성하여야 한다. 
프로젝트란 원천코드나 생성되는 class 파일，클라스경로의 설정 등을 묶어서 관리하기 
위한 단위 를 말한다. Eclipse 에 서 는 2개 이 상의 프로젝 트를 동시 에 작업 공간에 열 어 놓을 
수 있다. 

3.1.3. 프로젝트의 작성 

Eclipse 를 기 동시 켜 새 로 프로젝 트를 작성하는 절 차는 다음과 같다. 

차림 표띠 에 서 [ File ] ᅳ [ New ] —[ Project ] 를 선택 한다. 그러 면 새 프로젝 트를 작성 
하기 위한 대화칸이 현시된다(그림 3-2). 

B ■醫 ■■히 정！ 

Select a wizard ■■스 

Create a Java project 




그림 3-2. 새로운 프로젝트작성대화칸 

[Java Project ] 를 선택 하고 [ Next ] 단추를 찰칵한다. 

이 때 현시 되 는 대 화칸에 서 프로젝 트이 름과 보존등록부，프로젝 트안의 원천코드와 
class 파일의 등록부구성을 지정 한다. [Project name ] 에 《 SampleChap 3》 라고 입 력 한 
다. 프로젝트를 보존하는 [ Location ] 에서 기정의 [Create project in workspace ] 을 선 
택 함으로써 2장에서 지정 한 작업 공간인 《 / kut / workspace 》를 사용한다. [Project 
layout ] 는 [Create separate source and output folders ] 을 선택 한다. 이 렇게하면 
Java 원천코드는 프로젝트등록부아래의 src 등록부에 들어가며 class 파일은 bin 등록부아 
래에 생성된다(그림 3-3). 
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그림 3-3. 프로젝트이■의 입력 

여 기서 [Configure Defaults ] 단추를 찰칵하고 [Source and output : folder ] 에서 
[ Folders ] 를 선택 한다(그림 3-4). 



그림 3-4. 새 프로젝트에서 사용할 경로설정 

새 프로젝 트작성 대 화칸의 [ Finish ] 단추를 찰칵하면 Java 투시 가 자동적 으로 추가되 
고 그림 3-5 와 같은 화면 이 나타난다. 이 상으로 Java 프로그람을 작성 하기 위 한 준비 가 
완성된다. 
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4 불게방환경 Eclipse 



그림 3-5. 새로 생성된 프로젝트 


행번호의 표시 

기정설정으로는 Java 편집기의 행번호가 현 
시되지 않는다. 행번호를 참조할 때가 많기때문 
에 기정설정 을 변경하여 현시되 도록 하는것 이 좋 
다. 차림 표띠 에 서 [Window] [Preferences] 을 
선택하여 나타나는 대화칸의 왼쪽에서 [Java] ᅳ 
[Editor] 를 선택 한다. [Appearance] 래 브를 눌 
러 현시되는 대화칸에서 [Show line numbers] 

를 선택한다. 

그림 3-6. 행번호의 표시 
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3.1.4. 프로젝 트속성 (project property) 

여기서는 4 장에서 보게 되는 Junit 를 리용하여 클라스경로의 설정을 진행한다. 앞 
으로의 판본갱 신에 대 한 확장성 을 보장하기 위하여 일 단 클라스경 로를 junit. jar 로 설정 
하고 그 클라스경 로를 프로젝 트의 건립경 로로 설정한다. 구체 적 인 절 차는 다음과 같다. 

클라스경로변수의 설정이나 편집은 차림표띠의 [Window] —[Preferences] 에서 진 
행 한다. 여 기서 이 미 정의되 여 있는 클라스경 로변수는 [JUNIT_HOME] 이 라는것을 알수 
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있다. [ JUNIT _ HOME ] 을 선택한 상태에서 [ Edit ] 를 찰칵하여 현시되는 대화칸에서 보 
면 [ Name ] 에 는 《 JUNIT _ HOME 》 ， [ Path ] 에 는《 / kut / plugins / org . junit _3. 8. 1/》 
이 입 력 되 여있는것 을 확인할수 있 다(그림 3-7). 

여 기서 이 클라스경 로변수 [ JUNIT _ HOME ] 을 그대 로 리 용하기 로 하고 확인이 끝 
나면 [ Cancel ] 단추를 찰칵한다. 


교凶 


Cla^spalli Varcabtes 


A dis-siHHhi vidaJsk can be dikM io a proifK^E dasi (muHl If can be usisd la Mirw Che kKdikMi of a 



1C 


그림 3-7. 클라스경로변수의 확인 

이 조작에 의하여 현재 프로젝트에서는 junit.jar 에 대하여 클라스경로가 지정된다. 



그림 3-8. Java 건립경로의 추가 
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추가한 서고에 원천코드와 Javadoc 를 부가 

미 리 설정 되 여있는 클라스경 로변수 JUNIT_HOME 이 참조하고있는것 처 럼 
junit. jar 는 Eclipse 의 끼 워 넣 기 등록부 (/kut/eclipse/ plugins/orgjunit_3. 8.1) 에 
포함되 여있는데 junit. jar 에 원천과 Javadoc 를 부가하기 위 해서는 Junit 의 원천과 
Javadoc 가 필요하게 된다. 

그래서 Junit 의 압축파일 junit3.8.1 을 복사하고 풀면 junit. jar 와 함께 
src.jar 와 Javadoc 등록부도 작성된다. 이 파일들을《 /kut/junit/ 》아래에 보존한 
다. 여기서 JUNIT_HOME 에 Junit 의 원천인 src.jar 를 관련시킴으로써 Eclipse 가 
Junit 의 원천코드를 참조할수 있게 된다. 례하면 Ctrl 건을 누르면서 junit. jar 에 포 
함되 여있는 클라스나 메 쏘드우에 마우스유표를 맞추어 클릭하면 해 당한 원천코드에 
로 뛰 여넘기할수 있다. 

또한 마우스유표를 메쏘드나 클라스에 맞추면 원천코드안에 서술되여있는 
Javadoc 해설문이 튀여나오기도움말 (pop-up) 로 표시된다. 또한 내용물방조에도 원천코 
드안의 Javadoc 해설문이 표시된다 ( [3.2.12 해설문，해설문해제와 풍선도움말] 참고). 

src.jar 의 경로를 설정하는것도 junit.jar 의 경우처럼 먼저 차림표띠로부터 
[Window] —[Preferences] 을 선택 하여 표시되는 대화칸의 [Java], [Build Path] 
를 전개 하고 [Classpath Variable] 를 선택 한다. [New] 를 찰칵하면 클라스경 로변수 
[JUNIT_SRC] 를 작성 한다. 경로는 압축을 푼 후 src2.jar 의 장소인 c/ASCii/junit/src. jar 
를 지 정한다(그림 3-9). 



그림 3-9. 클라스경로변수 《 JUNIT _ SRC 〉> 의 작성 


[Package Exproler] 보기 에 서 프로젝 트 SampleChap3 을 선택 한 상태 에 서 차 
림 표띠 의 [File] —[Properties] 로부터 [Properties for SampleChap3] 대 화칸을 연 
다. 왼쪽화면에서 [Java Build Path] 를 선택하고 [Libraries] 태브를 누른다. 앞에 
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서 추가한 [ JUNIT _ HOME ] 를 전개하면 [Source attachment ] 가 표시 되 는데 이 것 
을 선택하고 [ Edit ] 를 찰칵한다. 이때 현시 되는 [Source Attachment Configura 吐 on ] 에 
서 [ Variable ] 를 찰칵하면 [Variable Selection ] 대화칸이 현시된다. 여기서 클라스 
경로변수 JUNIT_SRC 를 선택하고 [ OK ] 를 찰칵한다(그림 3-10). 이것으로 설정은 
끝난다. 



그림 3-10. 클라스경로변수 《 JUNIT _ SRC 〉> 의 선택 

마찬가지 로 [ JUNIT _ HOME ] 를 전개하면 표시 되 는 [Javadoc location ] 를 편 
집 하고 Junit 를 압축을 풀 때 생성되는 Javadoc 의 등록부를 지정 한다. Javadoc 의 
위치는 클라스변수경로가 아니라 실지 등록부인 《 / kut / juint / javadoc 》 를 지정한 
다. 이 조작에 의 하여 Junit 의 Javadoc 내 용이 Eclipse 의 도움말로부터 참조할수 
있게 된다. 


3.1.5. 들라스의 작성 

계 속하여 작성한 SampleChap 3 프로젝 트에 클라스파일 을 작성한다. 

먼저 HelloEmployee . java 를 작성 한다. [Package Explorer ] 보기 에서 [ src ] 등록 
부를 선택 한 다음 지 름차림 표를 열 고 [ New ] —[ Class ] 를 선택 한다. 

차림표띠의 [ File ] ᅳ [ New ] —[ Class ] 로서도 같은 조작을 할수 있다. 현시되는 대화 
칸에서 새 로 작성 하는 Java 클라스의 설정 을 진행 한다. [ Package ] 에 《 sample , hello 》 ， 
[ Name ] 에는 《 HelloEmployee 》 를， [ Modifiers ] 에는 [ public ] 를 지정 한다. 여기서 
는 [public static void main (String [] args )] 검 사칸을 선 택 하여 정 적 클라스를 작성 하 
도륵 하고있다(그림 3-11). 
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그림 3-11. 새 클라스의 작성 

[ Finish ] 단추를 찰칵하면 패 키지와 클라스이름， main 메쏘드가 이 미 정의된 
HelloEmployee . java 가 Java 편집기에 현시된다(그림 3-12). 
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그림 3-12. 생성된 클라스파일 
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제2절. Java 편집기의 사용법 

여 기서 는 견본코드를 작성 해 보면서 Eclipse 에서 Java 편집 기의 사용방법 에 대 하여 
설 명 하기 로 한다. 본문편집 기 등을 사용하여 코드를 작성할 때 보다 훨씬 개 발효률이 높 
아진다는것을 알수 있다. 

3.2.1. 메쏘드와 괄호의 자동설정 

먼저 간단한 System , out . prinln 를 리용하여 《Hello World 》 를 출력 하는 실례에 
대하여 보기로 한다. 

앞서 작성한 HelloEmployee . java 의 main 메쏘드안에 《 System . 》라고 입력 한 다 

음 잠간 기 다리면 그림 3_13와 같이 System 클라스에 포함되는 err , in , out , . 라 

는 마당 ( field ) 이 나 메쏘드의 후보가 표시된다. 이것 을 내 용물방조라고 부론다. 유표를 
아래 우로 이 동시 켜 후보중에 서 하나를 선택 하고 Enter 건을 누르면 선택한 마당이 자동입 
력된다. 또한 입력하려는 마당이름인 ou t 의 첫글자《0》를 건입력하는 방법으로 후보범위 
를 줄일수도 있다. 

Println 메쏘드의 입력도 마찬가지이다. 《.》을 입력하고 잠간 기다리면 마당 
System . out 의 PrintStream 클라스에 포함되는 메쏘드들이 입력후보로 표시된다. 많은 
후보가 표시되 기때 문에 《 println 》 을 건입 력하여 차례 로 후보를 줄여간다. 지 름건 Ctrl 
+ Space 를 누르면 내 용물방조를 곧 표시할수도 있다. println 메 쏘드의 인수에 《Hello 
World 》 를 입 력한다. 첫 인용부호를 입 력하면 이것 을 닫기 위한 인용부호가 자동적으로 
입 력되는것을 알수 있다. 이것도 Eclipe 에 의한 방조기능중의 하나로서 괄호의 자동설 
정이라고 한다. 인용괄호외에도 메쏘드의 중괄호나 인수의 소괄호 등도 자동입력되기때 
문에 괄호닫기를 잊 어버리는 오유를 방지할수 있다. 

public static void main (String [] args ) { 

System , out . println ( “Hello World ” ); 

} 

입력이 끝나면 차림표띠의 [ File ] ᅳ [ Save ] 에서 또는 지름건 Ctrl + S 를 리용하여 
원천코드를 보관한다. 기정설정에서는 이 시점에서 자동적으로 콤파일이 진행되고 bin 
등록부아래에 class 파일이 생성된다. 
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ui 등署방조가 
표시된다 


그림 3-13. 메쏘드나 마당의 ■른 선택 


건 립 

Eclipse 의 기정설정에서는 보통 원천코드를 보존하기만하면 건립된다. 그것은 차 
림표띠의 [ Window ] ᅳ [ Preferences ] 를 선택하여 현시되는 대화칸에서 

[ Workbench ] 를 선택 했을 때 [Build automatically ] 검사칸이 선택 상태 로 되 여있기 
때문이다. 처리부하가 크다는 리유로 이 선택표시를 해제시킨 경우에는 차림표띠에서 
[ Project ] ᅳ [Build Project ] 또는 [Build All ] 을 선택하여 건립한다. 지름건 Ctrl + 
B 를 리용해도 된다. 


3.2.2. 프로그람의 실행 

《 Hello World 》 를 실행하기로 한다. [Package Explorer ] 보기에서 
HelloEmployee.java 가 선택되여있는가를 확인한 다음 차림표띠에서 [ Run ] —[Run 
AS ] ᅳ [Java Application ] 을 찰칵한다. 그러면 선택한 클라스가 실행된다. 표준설정에 
서는 Java 편집기의 아래에 있는 [ Console ] 보기에 표준출력으로 《 HelloWorld 》 가 표 
시된다(그림 3_14). 
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그림 3-14. Hello W 아 Id 의 실행 

3.2.3. 보기 쉬운 원천코드의 작성 

Eclipse 에 는 원천코드를 보기 쉽 게 하기 위한 코드서 식 기 능， Javadoc 해 설 문의 추가 
기능 등이 있다. 

Java 편집기상에서 지름차림표의 [ Source ] ᅳ [ Format ] 를 선택함으로써 원천코드의 
들여쓰기，괄호의 위치맞추기 등을 할수 있다. 범위를 선택한 상태에서 서식화를 실행하 
면 선택된 부분에 대하여만 서식화가 적용된다. 

서 식화의 정의는 차림 표띠 에서 [ Window ] ᅳ [ Preferences ] 을 선택하면 현시되는 
대 화칸의 [ Java ] —[Code Style ] ^ [Code Forma 竹 er ] 에 서 진행 한다 (그림 3-15). 여 기 
서 [ New ] 를 찰칵하고 기존 외형 ( profile ) 에 기초하여 서식 을 정의한다. 행바꾸기，한 
행 당 문자수，들여 쓰기태 브의 개 수，공백 을 넣 을자리 등을 필 요에 따라 또는 해 당 프로 
젝 트의 개 발방향에 따라 설정한다. 
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그림 3-15. 쿄드서식기 
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사용자가 정의한 외형은 xml 형식으로 보존하거 나 읽어들일수 있으므로 개 발조안에 
서 설정을 공유할 때 편리하다. 보다 구체적인것은 [6.7.1. 코드서식기]에서 보기로 한다. 

Javadoc 용을 비롯한 해설문을 추가할 때도 그 일부를 자동적으로 삽입할수 있다. 
Java 클라스나 대면을 새로 작성하면 앞머리에 파일해설문이 삽입된다. 기정설정에서는 
코드를 생성한 날자가 삽입되 게 되 여있는데 설정 을 변경하여 기 업소이 름，저 작권 (copy 
right ), CVS 용태그 등을 삽입하도록 정의할수 있다. 

차림표띠의 [ Window ] —[ Preferences ] 을 찰칵하면 현시되는 [ Preferences ] 대화 
칸에 서 [ Java ] —[Code Style ] ^ [Code Templates ] 를 선택 한다. 화면오른쪽의 
[Configure generated code and comments ] 에서 [ Code ] 를 전개한다. [New Java files ] 
을 선택한 상태에서 [ Edit ] 단추를 찰칵하면 원형의 편집이 가능하게 된다(그림 3-16). 

메 쏘드에 대한 Javadoc 해설문은 메쏘드안에서 지름차림표를 열고 [ Source ] —[Add 
Javadoc Comment ] 를 선택하면 삽입된다. 메쏘드의 밖에서 동일한 조작을 진행하면 클 
라스에 대한 Javadoc 해설문이 추가된다. 변경하려고할 때에는 파일앞머리에 삽입되는 
파일 해 설문과 마찬가지 로 차림 표띠 의 [ Window ] —[ Preferences ] 를 선택 하면 현시 되 는 
대 화칸에 서 [ Java ] — [Code Style ] ^ [Code Templates ] 를 선택 한다. 

메쏘드에 대한 Javadoc 해설문은 [ Comments ] —[ Method ] 에서，그리고 클라스에 
대한 Javadoc 는 [ Comments ] —[ Types ] 에서 편집한다. 이 대화칸의 [Automatically 
add comments for new methods and types ] 검사칸의 선택표시를 해제함으로써 해설 
문을 자동적 으로 삽입하지 않도륵 할수도 있 다. 




t> Workbench 
t> Ant 
Build Order 
t> Help 

t> Install/Update 
Java 

> Appearance 

> Build Path 
▽ Code Style 

Code Formatter 
Code Templates 
Organize Imports 
Compiler 

> Debug 

> Editor 
Installed JREs 



Task Tags 
Type Filters 
t> Run/Debug 
t> Team 


rai 저 


Code Templates 

Configure generated code and comments: 

> Comments 

Edit... 


▽ Code 



New Java files 

Import.. 


Catch block body 



Method body 

| - Export... 


Constructor body 

Export All... 



Getter body 
Setter body 



0 Automatically add comments for new methods and types 
(Comments contained in the code patterns are always inserted) 

Restore Defaults Apply 
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그림 3-16. 쿄드의 형판 
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코드와 해 설문의 편집 은 편집 대 상을 선택한 다음 [ Edit ] 단추를 찰칵하여 진행한다. 
[Insert Variable ] 을 리 용하면 사용자명 과 현재 날자， CVS 태 그에 리 용할수 있는 $기 호 
등 미리 준비되여있는 변수를 유표의 위치에 넣을수 있다(그림 3-17). 



그림 3-17. 변수의 삽입 

3.2.4. [ Tasks ] 보기와 [ Problems ] 보기 

새 파일과 클라스가 작성될 때 TODO 과제가 추가된다. 보기 쉬운 코드가 되도록 
하기 위하여 TODO 부분을 될 수록 해 설 문으로 바꿔 놓도륵 한다. 

해설문에 대하여서만이 아니라 Eclipse 가 자동적으로 추가한 추상메쏘드의 대용체 
( stub ) , 원천의 자동입력 기능으로 추가된 try / catch 의 catch 문 등도 TODO 과제의 대 
상으로 되여있다. 이것은 Eclipse 가 자동적으로 생성 한 원천코드에 대 하여 후에 사용자가 
내용을 넣어 줄 필요가 있기때문에 잊지 않도륵 TODO 일람에 추가하여 관리하는것이다. 

TODO 과제일 람은 [ Tasks ] 보기 에 서 참조할수 있 다. 

[ Tasks ] 보기는 차림표띠의 [ Window ] —[Show View ] —[ Other ] 를 선택하면 현시 
되 는 대 화칸에 서 [ Basic ] 등록부를 전개 하고 [ Tasks ] 를 선택하면 추가된 다. 과제 는 사 
용자가 임의의 행에 대하여 추가할수도 있다. 추가하려는 행의 왼쪽 재색부분에서 지름 
차림 표의 [Add Task ] 를 선택한다. 또는 추가하려 는 행 에 유표가 놓인 상태 에 서 차림 표 
띠의 [ Edit ] ᅳ [Add Task ] 를 선택해도 된다. 이것은 현시점에서는 명세서가 결정되여 
있지 않지만 명세서가 결정된 후에 추가하려고 생각하고있는 부분 등에 TODO 과제를 
설정해둠으로써 코드넣기작업을 잊 어버리는 오유를 방지할수 있다. 사용자가 추가한 과 
제 에 대 해 서 는 완료표시 를 하거 나 삭제 하며 [ Tasks ] 보기 안의 완료표시 가 있 는 과제 만을 
골라 삭제하는것 과 같은 작업 을 진행할수 있 다. 

Eclipse 가 알아낸 콤파일오유와 경고 등은 [ Problems ] 보기에 자동적으로 추가되고 
표시된다. 매개 보기의 항목을 두번찰칵하면 다른 클라스가 열려져있어도 작업대상으로 
되고있는 클라스의 해당위치(행)에 뛰여넘기할수 있다. 
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3.2.5. 대면의 작성 

견본프로그람에 서 리 용하는 현시 용객 체 의 대 면 DisplsyObject . Java 를 작성 한다. 
패키지 sample . hello 에 작성하기때문에 [Package Explorer ] 보기에서 패키지를 선택 
한 다음 지름차림표를 열거나 또는 차림표띠의 [ File ] 에서 [ New ]— [ Interface ] 를 찰칵 
한다. 추가하려는 패 키지를 선택 하고 새 로운 대 면작성대 화칸을 연다. 이 대화칸의 패키 
지명 에 선택한 패 키지 가 기정 으로 표시되게 된다(그림 3-18). 



그림 3-18. 새로운 대면의 작성 

이름을 DisplyObject 라고 하고 대화칸을 담으면 대면클라스가 생성된다. 여기서 
DisplayObject 대면은 display 메쏘드를 가지고있는것으로 본다. Void display 0 를 아래 
와 같이 정 의한다. Javadoc 주석 도 써 놓는다. 

package sample . hello ； 
public interface DisplayObject { 

* 얻 은 결과를 출력한다. 

*/ 

void display 0 ； 

} 

그리고 DisplayObject . java 를 보존한다. 
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3.2.6. 대면의 실현 

우에 서 작성 한 대 면 DisplayObject 를 추가한 Employee , java 를 작성 한다. 이 클 
라스는 XML 파일로부터 읽어들인 종업원에 관한 속성을 보유하는 JavaBean 이다. 

대 면을 새 로 작성할 때 와 마찬가지 로 sample , hello 패 키지를 선택한 다음에 클라스 
의 새로 작성을 진행하면 패키지명이 미리 입력된 대화칸이 현시된다. [ Name ] 에 Java 
클라스이름으로 《 Employee 》 를 입 력한다. 계속하여 [ Interface ] 의 [ Add ] 를 찰칵하면 
[Implemented Interfaces Selection ] 대화칸이 현시 된 다. 추가하려는 대면이름인 
《 DisplayObject 》를 입력해가면 입력되는 대면이름에 부합되는 후보가 아래에 현시된 
다(그림 3-19). 



그림 3-19. 대면의 선택 

DisplayObject 를 선택 하고 패 키지 가 이 미 작성 한 sample , hello 로 되 여 있는가를 
확인한 다음 [ OK ] 단추를 찰칵한다. 계승된 추상메쏘드의 대용체 ( stub ) 를 작성 하도록 
선택표시칸이 표시되여있다는것을 확인한 다음 끝낸다(그림 3-20). 
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Java Class 

Create a new Java class. 


© 


Source Folder SampleChap3/src 

Browse... 

Package: | sample.hello 

Browse... 

□ Enclosing type: 



Name: Employee 


Modifiers: ® public ◦ default 

□ abstract □ fir 맨 

◦ p_ 

□ 

o" ' 


Superclass: java.Iang.Object 



Browse... 

interfaces: O sample.hello.DisplayObject 



Add … 




Remove 


Which method stubs would you like to create? 


□ public static void main(Strin£[] args) 

□ Constructors from superclass 
0 Inherited abstract methods 


Einish 


그림 3-20. 대면의 실현 

3.2.7. Setter , Getter 의 자동생성 

JavaBean 인 Employee . java 에 Setter ^ Getter ^ 추가한다. 우선 접근선언자 
private 의 속성과 구성 자를 정의 한다. 여 기서는 종업 원자료 즉 종업 원번호 ( ID ), 이름， 
직위，전화번호，책 임 자에 대 한 정보로 된 5가지 속성 에 대 하여 정의한다. 

public class Employee implements DisplayObject { 
private String id ； // 종업원번호 

private String name ； // 이름 

private String role ； // 직위 

private String telNumber ； // 전화번호 

private String boss ； // 책임자 

public Employee (String id , String name , String role , String 

telNumber ) { 

this , id = id ； 

this , name = name ； 

this.role = role ； 

this . telNumber = telNumber ； 
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public void display 0 { 
// TODO 


다음으로 Java 편집기상의 속성을 선언하고있는 부분에 유표를 놓고 지름차림표를 
연 다음 [ Source ] —[Generate Getters and Se 竹 ers ] 을 선택한다. 이때 나타나는 대화 
칸에서 생성하려는 메쏘드를 선택한다. 현재의 견본에서는 속성값을 설정할 때 구성자로 
묶어서 진행 하도록 하고있기때 문에 여기서는 Getter 만을 생성한다. [Select Ge 竹 ers ] 을 
찰칵하면 매 속성의 get 메쏘드가 선택표시된다. 이것을 확인한 다음 [ OK ] 단추를 찰칵 
한다(그림 3-21). 



그림 3-21. Getter 의 생성 

Java 편집기상에서 종업원번호 (String id ) , 이름 (String name ) , 직위 (String rol 
e ), 전화번호 (String telNumber ), 책임자정보 (Employee boss ) 의 5 개 속성에 대하여 
생성된 Ge 竹 er 메쏘드를 확인할수 있다(그림 3-22). 
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그림 3-22. Getter 메쏘드가 추가된 다음의 Java 편집기 


Getter 및 Setter 의 생성에서 판본 2. 1과 판본 3. 0의 차이점 

판본 3.0 에서는 2.1 에서의 다음과 같은 점 이 변경되였다. 

1. Javadoc 해 설 문이 Getter 용과 Setter 용으로 각각 따로 지 정할수 있게 되 였 
다. 판본 2.0 까지는 Setter , Getter 전용의 Javadoc 해설문이 자동적으로 생성되였으 
나 국제화대응문제 등이 있어서 2.1 에서 일부 기능이 삭제되였다. 그 대신 보통 새 
메쏘드에 대하여 쓰이는 Javadoc 해설문이 삽입되였는데 3.0 에서는 각각 전용 Java 
doc 해설문이 [Code Template ] 의 [ Comment ] 설정에서 전용화할수 있게 되였다. 
([코드형판]에 대하여서는 [3.2.3 보기 쉬운 원천코드의 작성]을 참고할것). 

2. Setter 의 인수가 마당이 름에 의 하여 만들어 진다는 내 용으로 다시 변경 되 였 
다. 판본 2.1 에서 Setter 의 인수는 인수의 형에 기초하여 생성되도록 변경되였으나 
판본 3.0 에서는 2.0 까지에서 와 마찬가지 로 마당이름이 쓰이게 되 였다. 

String name ； 

public void setName(String string ) { // 판본 2.1 
name = string ； 


public void setName (String string ) { // 판본 2.0 이 전 및 3.0 
this , name = name ； 
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3.2.8. 반입기능 

새 로 Java 원천코드를 작성 할뿐아니 라 반입 ( import ) 기 능을 리 용하여 다른곳에 있는 
원천코드를 프로젝트에 추가할수 있다. 

XML 를 읽어들이기 위한 편의클라스 (utility class ) 파일인 XmlUtil . java 와 종업원 
속성 을 넣은 EmployeeMap . java , EmployeeMap 를 생성하기 위한 EmployeeMapFactory . java 
의 3개파일을 프로젝트의 sample . hello 패키지에 반입한다. 

우선 [Package Explorer ] 보기에서 반입 목적지로 되는 sample , hello 패키지를 선 
택한다. 다음 차림 표띠 의 [ File ] ᅳ [ Import ] 를 선택하면 현시 되 는 대 화칸에 서 
[File system ] 를 선택 한다. [ Next ] 단추를 찰칵하면 나타나는 대 화칸의 [From directo 
ry ] 로 [ root ] / SampleP rojects / Chapter 3 / SampleChap 3 

/ src / sample / hello 를 지정한다. (우의 지정경로에 파일이 있다고 가정한다.) Hello 
등록부에 포함되는 Java 파일이 오른쪽에 표시된다. 

여기서 반입대상들인 
XmlUtil . java 
EmployeeMap . java 
EmployeeMapFactory . java 

의 3 개파일 을 검 사칸에 서 선택한다. 반입 목적 지 의 서 류철 [Into folder ] 가 
《 SampleChap 3/ src / sample / hello 》 로 되여있는가를 확인하고 [ Finish ] 단추를 찰칵 
한다(그림 3-23). 


File system 

Import resources from the local file system. 


~nnfxj 

I 축 


From directoiy: i/opt/Chapter3/SampleChap3/src/sample/hello 


—0 


hello 


DisplayObject.java 


□ B Employee.java 

0 2l EmployeeMapjava 
0 2) EmployeeMapFactory .java 

□ 2) HelloEmployee.java 
0 函 XmlUtil.java 


Rlterlypes... 


Select All 


Deselect All 


Into folder. SampleChap3/src/sample/hello 


Options: 

□ Overwrite existing resources without warning 
O Create complete folder structure 
® Create selected folders only 



Rnish 



그림 3-23. 파일체계로부터의 반입 


錢變邊 0變變©繼鹽 


65 























H 너•參於경 Eclipse 


프로젝트 열기 一 프로젝트의 반입 

현재 작업 공간에 열 려 져 있지 않은 Eclipse 프로젝 트를 작업 공간상에 현시하는 기 능 
도 Eclipse 에 서 는 반입기 능에 포함되 여있 다. 례 를 들어 CD-ROM 으로부터 견본프로 
젝트를 새로 Eclipse 에 불러들여 참조편집하는 경우에 반입기능을 리용한다. 이러한 
작업을 Visual Studio 와 같은 다른 개발도구들에서는《프로젝트 열기》라고 한다. 

열려고하는 프로젝트를《 C / workspace / 》에 복사한다. 복사한 등록부의 파일속 
성은 읽기전용으로 되여있는 경우가 있으므로 등록부이하에 있는 모든것들에 대하여 
그 속성 을 해 제 한다. 

다음 Eclipse 의 차림 표띠 에 서 [ File ] ᅳ [ Import ] 를 선택하면 현시 되 는 대 화칸에 서 
[Existing Project into Workspace ] 를 선택한다. [ Next ] 단추를 찰칵하고 [Project 
contents ] 의 [ Browse ] 를 눌러 현시되는 대화칸에서 우에서 복사한 프로젝트의 등록 
부를 선택한다(그림 3-24). 프로젝트이름은 열 려는 project 파일에 이미 정의되 여있기 
때 문에 반입할 때 지 정할수 없 다. 



그림 3-24. 프로젝트의 등록부를 선택 
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3.2.9. 즉시수정기능 

반입 이 끝나면 [Package Explorer] 보기에 콤파일오유를 가리 키는 빨간 표식 이 있 
을것 이 다. [Package Explorer] 보기 에서 오유가 있는 EmployeeMapFactor. java 를 열 
면 Java 편집기의 오른쪽끝의 회색부분에도 빨간 표식이 붙어있다. 여기를 찰칵하면 오 
유가 있는곳으로 유표가 이동된다. [Problems] 보기에도 오유가 표시되기때문에 이것을 
두번찰칵해도 오유가 있는곳으로 이동할수 있다(그림 3-25). 



..나 . a » |D|B I ᄐ_ ■ᅳ *lp AnnliQ | ■ me ' | [!.l 베， 때 메미 J 丄 在 Cl ! S ^ QJ 1(，il 

그림 3-25. 반입의 완료와 콤파일오유 

오유행 의 왼쪽끝부분에 노란색 의 전구표식 과 빨간색 의 문제표식 이 있는것 을 확인할수 
있 다. 문제표식 에 유표를 맞추면 오유내 용이 표시 된다. 또한 전구를 찰칵하면 즉시 수정 
(quick fix) 기 능에 의 하여 자동수정 이 가능하게 되 는 [Proposal Fix List] 이 현시 된다. 
여기서는 수정후보로서 

메쏘드 ‘setBoss(Eployee) ’ 를 Employee, java 에 작성 한다. 

형변환을 ‘employee’ 에 추가 
파일안에서 이름변경한다. 

의 3가지 내용이 현시된다(그림 3-26). 




錢變邊 0變變©繼鹽 


67 


































H 너•參於경 Eclipse 



그림 3-26. 즉시수정기능 

[3.2.7 Setter , Getter 의 자동생 성 ] 에 서 편집 한 Employee , java 에 서 는 Getter 메쏘 
드만을 작성하고 Setter 메 쏘드는 작성 하지 않았다. 오유가 생긴 EmployeeMapFactory . java 
에서는 속성 Boss 에 대하여 Se 竹 er 메쏘드를 설정해야 한다는것을 보여주고있다. 

그래 서 즉시 수정 기 능을 리 용하여 Employee , java 에 setBoss 메 쏘드를 작성 하기 로 
한다. 수정 후보로 표시 되 여 있는 [Create method ‘ setBoss ( Employee ) ’ in 
Employee , java (메 쏘드 ‘ setBoss ( Employee ) ’ 를 Employee . Java 에 작성 한다) ] 를 
선택하면 오른쪽에 도움말이 나타나고 삽입하려는 메쏘드가 표시된다. 이것을 확인한 다 
음 Enter 건을 누르면 Employee . java 에 대하여 setBoss 메쏘드의 코드형판이 추가되므 
로 Setter 메쏘드를 아래와 같이 입력한다. 

public void setBoss (Employee boss ) { 
this , boss = boss ； 

} 

여기서 Employee . java 를 보관하면 [ Problems ] 보기에 표시되여 있었던 오유도 없 
어진다(그림 3-27). 
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그림 3-27. setBoss 의 추가 

즉시수정기능을 리용하면 우에서와 같이 메쏘드를 추가하는것뿐아니라 부족한 
import 문과 입력한 철자법오유 등에 대하여서도 오유행 왼쪽끝의 노란색전구를 찰칵하 
여 수정후보를 선택하는 방법으로도 수정할수 있다. 지름건으로 Ctrl + 1이 할당되여있다. 

오유수정은 아니지 만 어 느정도 원천코드를 써 넣은 후에 국부변수의 이름을 변경하려 
고하는 경 우에 는 [Local name change ] 즉시 수정 기 능을 리 용하는 쪽이 편 리하다. 변경 
하려는 변수에 유표를 맞추고 Ctrl + 1 또는 차림표띠에서 [ Edit ] —[Quick Fix ] 을 선택 
한다. 튀 여 나온 형 판에 서 [Rename in file ] 를 선택 한 후에 변수이 름을 바꾸어 주면 메 
쏘드안이나 Javadoc 해설문안 등 다른 장소에서 쓰이고있는 변수의 이름도 동시에 변경 
된 다. 


3.2.10. 형 판에 의한 자동기 능 

Eclipse 에서는 [3.2.1. 메쏘드와 괄호의 자동설정]에서 본바와 같이 클라스에 포함 
되는 메쏘드나 마당의 자동설정 기능을 가지 고있을뿐아니 라 사용자가 정의한 문자렬도 동 
일 한 조작에 의하여 자동적 으로 입 력할수 있 다. 

일 반적 으로 자주 리 용되 는 문구들은 형 판으로서 미 리 등록되 여있 다. 
try/catch 문을 작성하는 실례 를 보기 로 하자. 

Java 편집기에서 try 라고 입력하고 Ctrl + Space 건을 누른다. 이것은 메쏘드를 자동 
설정할 때와 같은 조작이다. 이 조작에 의하여 내용물방조 (contents assist ) 가 표시된다 
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(그림 3-28). 일 반예 약어 인 [try] 외 에 [try-try catch block] 라는 후보가 표시 되 는데 
[try -try catch block] 을 선택 하고 Enter 건을 누른다. Java 편집 기상에서 례외처 리를 
진행 해 야 하는 부분에 try/catch 문이 작성 되 고 유표가 놓인다. Try 문에 서 발생 하는 례 
외형을 입 력하고 Tab 건을 누르면 계속하여 catch 문의 유효범위안으로 유표가 옮겨진다. 
catch 문은 TODO 과제로서도 추가된다. 



그림 3-28. 형판에 의한 자동삽입 


그외 에 도 

sysout System, out. println 

syserr System, err. println 

for for 문 

while while 문 

public_method public 메 쏘드 

main main 메 쏘드 

등 수많은 형 판이 준비 되 여있 다. 

차림 표띠 의 [Window] ᅳ [Preferences] 을 선택하면 현시 되 는 대 화칸에 서 [Java] 
ᅳ [Editor] ᅳ [Templates] 순서 로 열 어나가면 일 람을 확인할수 있 다. 이 대 화칸에 서 사 
용자가 독자적으로 형 판을 새 로 정의할수도 있고 이미 정의되 여있는 형 판을 편집할수도 
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있다. 그림 3-29 안의 [Name] 마당에 표시되여 있는 문자를 입력하고 Ctrl + Space 를 누 
르면 내용물방조가 현시된다. 




> Workbench 

> Ant 

Build Order 

> Help 

> Install/Update 
▽ Java 


> Appearance 
t> Build Path 

> Code Style 
Compiler 

> Debug 
▽ Editor 


Code Assist 
Mark Occurrences 
Spelling 



Task Tags 
Type Rlters 
t> Run/Debug 


■豆] 호] 

Templates 

Create, edit or remove templates: 



Import... 


Export... 



그림 3-29. 정의되여 있는 형판일람 

3.2.11. TODO 과제의 추가 

현재 남아있는 TODO 과제를 과제보기로부터 참조하면 Employee.java 의 display 
메 쏘드가 아직 추가되 여있지 않는것 을 알수 있다. 

public void display 0 { 

// TODO 

} 

//TODO 로 시 작되 는 행 을 아래 와 같이 변경 함으로써 메 쏘드를 삽입한다. TODO 행 
을 삭제하면 과제보기 의 목록도 삭제 된 다. 

[3.2.10. 형 판에 의한 자동기 능] 에 서 소개한 방법 을 리 용해 보기 로 한다. sys 라고 
입 력 하고 지 름건 Ctrl + Space 로 내 용물방조를 표시한다. sysout 라는 이 름으로 
System.out.printlnO 가 등록되 여있으므로 이것을 선택한다. 
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* 종업원정보를 표준으로 출력한다. 

*/ 

public void display 0 { 

System . out.println ( “종업원번호 =” + id ); 
System , out . println ( “종업 원 이 름 =” + name ) ； 
System , out . println ( “직 위 ” 牛 role ) ； 

System , out . println ( “전화번호” + telNumber ) ； 
System , out . println ( “책 임 자” + boss ) ； 

System , out . println 0 ; 


계 속하여 Employee 객 체 를 표시 하기 위 하여 아래 의 메 쏘드를 추가한다. 


* 이 객체를 문자렬화한다. 

*/ 

public String toStringO { 
return “[” 

+ id + “，” 

+ name + 

+ role + “，” 

+ telNumber + 

+ boss + “] ” ; 


3.2.12. 해설문，해설문해제와 풍선도움말 

어떤 부분의 원천코드를 한묶음으로 하여 해설문을 작성하려고 할 때에는 해당부분 
을 선택 한 상태 에 서 지 름차림 표의 [ Source ] —[Toggle Comment ] 의 조작으로 행 머 리 
에〈〈//》를 삽입할수 있다. 이 조작에는 지름건이 할당되여있는데 원천코드를 선택한 후 
에 《Ctrl + /》를 누르면 동일한 동작이 가능하다. 해설문을 해제할 때 에는 해 당부분을 
선택 하고 다시 같은 건조작을 진행한다. 

〈〈/*》과《*/》로 묶은 블로크해설문을 만드는 경우에는 해당부분을 선택한 상태에 
서 [ Source ] —[Add Block Comment ] 를 선택 한다. 지 름건은 《Ctrl +Shift + /》이 
고 블로크해설문의 해제도 이 건을 리용한다. 

여기서 HelloEmployee 의 main 메쏘드를 실례들어 본다. 먼저 main 메쏘드의 
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《 System , out . println ( “Hello World ” );》 를 선택하고 《Ctrl + /》 로 해설 문을 작 
성한다. 이 례 는 한행 이 기때 문에 그닥 편리성 을 느끼지 못하지 만 여 러 행 에 대 해서 해 설 
문과 해 설문해 제 를 반복할 때 에 는 매 우 편리 한 기 능이 다. 계 속하여 
EmployeeMapFactory 클라스의 구체 례 를 XML 파일 을 인수로 하여 작성한다. 
createEmployeeMap 메 쏘드를 리 용하여 종업원속성을 보존한 JavaBean 인 Employee 
를 넣 은 EmployeeMap 를 작성한다. 마지 막으로 EmployeeMap 의 display 메 쏘드에 
의하여 표준출력한다. 

public static void main (String [] srgs ) { 

// System , out . println ( “Hello World ” ) ； 

EmployeeMapFactory eFactory = new EmployeeMapFactory ( “empl 
oyee . xml ” ); 

EmployeeMap eMap = eFactory . createEmployeeMap 0 : 
eMap . display 0 ； 

} 

eMap . displayC ^ 입력 할 때 eMap . 이 라고 입 력한 상태 에서 잠간 기 다리든지 아 
니면 Ctrl + Space 를 누른다. 그러면 내용물방조에 입력가능한 객체의 성원 
( EmployeeMap 에 포함되 는 메 쏘드)이 현시 된다. 내 용물방조의 항목을 선택하면 그 오 
른쪽의 풍선도움말에 설명문이 나타난다. 이 설명문은 원천코드안의 Javadoc 해설문을 
참고하고있다(그림 3-30). 



그림 3-30. Javadoc 해설문을 리용한 참조 
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입 력 되 여있는 메 쏘드나 구체 례 에 유표를 맞추어 도 풍선도움말에 표시 되 는 것 과 동일 
한 설명문이 나타난다. 

3.2.13. XML 파일의 작성 

견본프로그람이 읽 어들이는 종업원정보가 들어 있는 XML 파일을 작성 한다. 

프로젝 트서 류철 인 SampleChap 3 바로아래 에 새 로운 파일 을 작성 하기 위 하여 
[Package Explorer ] 보기에서 프로젝트 SampleChap 3 을 선택하고 지름차림표의 
[ New ] —[ File ] 을 선택한다. 또한 차림표띠에서 [ File ] —[ New ] —[ File ] 을 선택하여도 
같은 조작을 한것 으로 된다. 생 성 하려 는 서 류철은 《 SampleChap 3》 으로 하고 파일 이 름은 
《 employee . xml 》 로 한다(그림 3-31). [ Finish ] 단추를 찰칵하면 빈 파일이 생성된다. 



그림 3-31. 파일의 새로 작성 

확장자와 리용하려는 편집기에 관한 설정은 차림표띠의 [ Window ] ᅳ 
[ Preferences ] 을 선택 하면 현시 되 는 대 화칸의 [ Workbench ] —[File Associations ] 에 
서 설 정할수 있 다(그림 3-32). 
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그림 3-32. 확장자와 파일형 

[Add] 단추를 찰칵하고 파일형 에 《 .xml 》를 입 력 한다. 다음으로 [Associated 
editors] 의 [Add] 로부터 례 하면 [Text Editor] 를 선택 한다. Eclipse 에는 여 러 개의 
XML 편집기끼워넣기 가 있으므로 요구하는 XML 끼 워넣 기를 설 치하여 사용할수 있다. 
Xml 편집기를 리용하면 태그의 색갈이나 륜곽 등을 표시할수 있게 된다. 

여 기서 는 목록 3-1 에서 본 XML 파일을 작성한다. 
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제3절. 실행과 기동구성의 설정 

Java 응용프로그람의 기동방법으로서 [3.2.2. 프로그람의 실행]에서 main 메쏘드가 
포함된 클라스를 선택 한 다음 [Run] —[Run As] —[Java Application] 을 선택 하는 방 
법 을 이 미 소개하였다 . HelloEmployee.java 를 선택 하고 이 방법 으로 한번 실행 해 보면 
Console 보기에 XML 로 서술한 내용이 출력된다 . 

이 절에서는 인수의 설정 등을 포함하는 보다 복잡한 실행방법과 그 관리기능에 대 
하여 설명한다 . Eclipse 에서 는 프로그람을 실행 하기 위한 설정 을 기동구성 이 라고 부론다 . 
기동클라스 HelloEmployee.java 에서는 종업원정보를 읽어들이기 위한 XML 파일을 원 
천코드안에 서 술하고있는데 이것을 프로그람인수로 지정하도록 변경한다 . 먼저 프로그람 
을 아래 와 같이 수정한다 . 

public class HelloEmploee { 
public static void main (String [] args) { 


EmployeeMapFactory eFactory = new 
EmployeeMapFactory( “employee.xml” ) ； 
EmployeeMap eMap = eFactory. createEmployeeMapO ； 
eMap. display 0 ； 


public class HelloEmpyee { 

public static void main (String [] args) { 
if (args. length != 1) { 

System.out.println( “Usage: java sample.hello. 
HelloEmployee XML_FILE); 

return ； 

} 

EmployeeMapFactory eFactory = new 

EmployeeMapFactory (args [0]); 

EmployeeMap eMap = eFactory. createEmployeeMapO ； 
eMap. display 0 ； 
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프로그람을 수정 한 후에 우에서 설명한 절 차대 로 실행하면 표준출력 에 Usage 가 현 
시된 다. 

그다음 인수를 지 정 하기 위 한 기 동구성 을 새 로 작성 한다. 차림 표띠 에 서 
[Run] ᅳ [Run] 을 선택하면 [Run] 대화칸이 나타난다. 도구띠우의 실행단추의 내 리펼 
침 (pull-down) 에 서 [Run] 을 선택 하여 도 같은 조작이 가능하다. 3. 2. 2 에 서 한번 실 행 
한적 이 있 으면 《HelloEmployee》 의 기 동구성 이 이 미 Java 응용의 아래 에 추가되 여있 다. 

이 것과는 별도로 새 로 기동구성 을 작성한다. 대 화칸왼쪽의 [Configurations] 에서 
[Java Application] 을 선택 하고 [New] 단추를 찰칵하면 현시 되 는 대 화칸에 서 작성 하려 
는 기동구성의 이름을 입 력한다. 이름은 임의 로 입 력할수 있는데 여 기서는 
《 SampleChap3_arg xmlfile》 로 입 
력 한다 . [P roject] 에 는 《 SampleChap3 》 

이 기정값으로 입력되여있다. 계속하 
여 [Main class] 를 지 정한다. 

[Search] 단추를 찰칵하면 프로젝 트안 
의 클라스 중에서 main 메 쏘드를 포함 하 
는것 이 검색된다 (HelloEmployee. java 
를 선택한 상태 에 서 [Run] 대 화칸을 
표시 하고 새 로작성 을 진행 하면 프로젝 
트，주클라스 의 입력마당들에 미리 기 
정값이 입력된 상태로 되기때문에 검 
색 공정 을 생략할수 있다). HelloEmployee 
를 선택 하고 [OK] 단추를 찰칵한다(그 
림 3-33). 

계속하여 [Arguments] 태브를 선택 
하고 Main 메쏘드의 인수로 되는 [Program arguments] 에 xml 파일이름 《employee.xml》 
를 입 력한다(그림 3-34). [Apply] 단추를 찰칵하면 이 기 동구성 을 보존하고 실 행한다. 

이외에도 [Arguments] 래브에서는 -D 추가선택이나 -Xmx 를 비롯한 가상기계인수 
와 작업등록부의 지정이 가능하다. 




Create, manage, and run configurations 

Create a configuration that will launch a Java virtual machine. 


Configurations: Name: SampleChap3 j-arg xmlfile 


BJava Applet 
r EJava Application 
B HelloEmployee 
JuJUnit 


I © Main | 的： Arguments | 5, JRE | Classpath | : Source |> 


SampleChap3 


Main class 


j sample.hello. 卜 telloEmployee 


Search... 


□ Include external jars when searching for a main class 

□ Include inherited mains when searching for a main class 


□ Stop in rr 


Apply Revert 


close 


그림 3-33. 기동구성의 작성 
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그림 3-34. 인수의 지정 


JRE 의 지정 

Eclipse 에서 는 실행 에 리 용하는 Java 실행 환경 의 판본을 기동구성별로 지정할수 
있다. 일상적인 체계개발에서는 여러개의 JRE 를 바꿔쓸 일이 많지 않지만 JRE 판 
본의 차이 에 의한 동작의 비교 등을 시험할 때 에는 편리하다. 



그림 3-35. JRE 의 지정 
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세 3 강 . Eclipse 에 到 4 JavalJL 그讀과생 


JRE 의 지정은 [ Run ] 대화칸의 [ JRE ] 태브에서 진행한다(그림 3-35). 

차림 표띠 에 서 [ Window ] ᅳ [ Preferences ] 를 선택하면 현시 되 는 대 화칸의 
[ Java ] ᅳ [Installed JREs ] 에 서 미 리 등록해 놓은 Java 실 행 환경 을 선택할수도 있 고 
웃그림 의 대 화칸에 서 [Alternate JRE ] 를 선택 하고 [Installed JREs ] 단추로 새 로 
Java 실행환경을 추가할수도 있다. 
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제4장. Eclipse 를 리용한 시험 
제1절. 시험틀거리 (testing framework ) 

최 근에 쏘프트웨 어부문에서 자주 framework 라는 말을 쓰군 한다. 쏘프트웨 어 공학 
에서는 framework 란 틀거리자체를 정해놓고 그 틀거리에 따라 목적을 실현한다. 

이 장에 서 소개하는 시 험 틀거 리 란 단위 시 험 (unit test) 을 자동화하기 위한 기 틀 즉 
단위시험을 자동화하기 위한 쏘프트웨어적인 틀거 리 이 다. 체계개 발에서 품이 가장 많이 
드는 일중의 하나가 단위시험과 접수시험이다. 이러한 품을 덜어주는 시험기틀이라는 개 
념은 XP 라는 개 발방법론으로부터 생겨 났다. 

4.1.1. XP 

XP 는 extreme Programming 의 략어로서 개발수법중의 하나이다. XP 는 
UP (Unified Process) 와 같이 다량적인 문서를 요구하는 규모가 큰 무거운 방법론과는 
달리 작성하는 문서 의 량보다 코드의 질 을 우선시 하는 소규모의 가벼 운 개 발수법 이 다. 
XP 를 실지로 적용하려고할 때에는 14 가지의 준수사항을 지켜야 한다. 대표적인 준수사 
항에는 40 시간로동，개편，쌍프로그람작성，시험구동 등이 있다. 

4.1.2. 시험구동프로그람작성 

XP 수법 에 의한 프로그람개 발에서 가장 큰 특징 은 시 험 구동이다. 시 험 구동은 대 상 
하는 프로그람을 작성하는것 과 동시 에 시 험 코드도 병 행하여 서 술한다. 

시험구동으로 코드를 서술하는것 이 가지는 우점은 다음과 같다. 

• 외부명세서를 명확히 할수 있다. 

외부명세서 란 대 상코드에 대 한 내 용을 말한다. 시 험코드를 병 행하여 서 술함으로써 
명세서에서 빠진것을 발견하거나 명세서가운데서 애매한 부분이 명백해지기도 한다. 그 
결과 대상코드의 외부명세서가 명백해지게 된다. 삽입되는 코드의 외부명세서가 명백해 
지 면 코드의 수정 및 확장이 쉬 워전다. 

• 코드의 품질이 향상된다. 

시 험과 병 행 하여 코드가 서술된다는것은 결국 서술된 코드는 항상 시험을 통과한 상 
태 에 있게 된다는것을 의 미한다. 또한 시 험 에서 통과되 려 면 정 확한 코드를 써 야 하기때 
문에 서술한 코드의 품질은 분명히 높아지게 된다. 

• 회귀시험을 자동화할수 있다. 

회귀시 험은 프로그람을 수정할 때 다른 개소에 영 향이 파급되 여있지 않는가를 확인 
하는 시험 이 다. 
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처음에 서술한 시험코드는 회귀시험을 진행할 때 재 리용할수 있다. 시험틀거 리는 서 
술한 코드의 실행을 자동화하는 물림새이므로 필연적으로 회귀시험도 자동화되게 된다. 

• 개편을 진행한다. 

개편을 진행하면 외부로부터 본 프로그람의 거동을 변화시키지 않고 프로그람을 깨 
끗하게 수정할수 있다. 그러나 동작하고있는 프로그람을 변경하기때문에 실지로 거동에 
서 변화가 없는지 의문을 가질수 있다. 거동이 변했는가를 확인하기 위하여 회귀 
( regression ) 시험 을 진행 한다. 시험을 통과하면 거동이 변하지 않았다는것 이 담보된다. 

대상코드와 시험코드를 병 행하여 서술하면 대상코드의 외부명세서 가 명백 해 진다. 그 
러한 의미에서 시험코드는 정확한 외부명세서라고 볼수 있다. 왜냐하면 시험코드는 프로 
그람코드로서 서술되며 시험에 통과되였다면 시험에서 서술된 명세서대로 코드가 동작한 
다는것 이 담보되 기 때 문이 다. 

물론 보수나 수정에서는 자연언어로 서술된 명세서가 필요하다. 그러나 자연언어로 
쓴 명세서는 실행을 할수 없지만 시험코드는 실행가능하다. 그러므로 자연언어로 서술된 
명세서에 비하면 압도적으로 프로그람의 검증이 헐해진다. 


시험과 병행하여 코드률 작성한다. 

론리 가 복잡한 코드를 작성하는 경우에는 시 험과 병 행하는 방법 이 목표가 뚜렷 
해질수 있다. 한편 목표가 제대로 정해지지 않은 경우에는 서술하는 코드의 역할도 
명 확하지 않을 때 가 많다. 복잡한 코드를 작성할 때 시험과 병 행하여 코드를 서술하 
는 쪽이 실지 로 완성할 때 까지 의 시 간이 단축되 군한다. 그러 므로 복잡한 코드를 쓸 
때 에는 시 험을 병 행하여 코드를 작성하는것 이 좋다. 


4.1.3. 단위시험，접수시험 

XP 수법에서 시험은 단위시험과 접수시험 (acceptance test ) 의 2가지로 구분된다. 단 
위시험은 단일체시험 이 라고도 부르는데 주로 쏘프트웨 어개 발자의 립 장에서 진행 하는 시험 
이 며 일 반적 으로는 시 험구동식프로그람개 발에 서 작성 되 는 시 험코드를 가리킨다. 한편 접 
수시험은 쏘프트웨 어 리용자의 립장에서 진행되는 시험이며 사용자가 실지로 그 쏘프트웨 
어를 리용하는 경우에 시험이 실시된다. 이 두 시험 가운데서 단위시험을 지원하고 회귀 
시험을 자동화해주는 도구가 JUnit 이다. 
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제2절. JUnit 의 설정 

여기서는 JUnit 를 사용한 시험구동프로그람작성에 대하여 취급한다. JUnit 를 쓰러 
면 《 http :// www . junit . org 》 로부터 코드를 내 리 적재 하거 나 Eclipse 의 plugins 등록 
부에 있는 JUnit 3.8.1 을 리용한다. JUnit 의 건립경로설정，클라스경로변수 JUNIT_HOME 
등을 설 정 하는 구체 적 인 방법 에 대 하여 서 는 제 3장을 참고하면 된 다. 

제3절. JUnit 의 기초 

4.3.1. 시험구동프로그람작성 

먼저 간단한 례를 들어 JUnit 의 사용방법에 대하여 설명하기로 한다. 앞장에서도 
나온 Hello World 의 실례 를 가지 고 JUnit 의 시 험 구동프로그람을 작성한다. 이제 다음 
과 같은 경우를 가정해본다. 


어떤 프로젝트에서 여러가지 클라스에 인사를 보내는 Hello 라는 클라스를 만든 
다. 이것은 프로젝트안에서 의사소통을 잘 하기 위한 클라스이 다. 


그러면 이 클라스의 명세서 는 다음과 같이 구성할수 있다. 


Hello 클라스는 String getGreeting (String name ) 라는 메 쏘드를 가진다. 이 
getGreeting 메쏘드는 인수 ( name ) 의 문자렬앞에 문자렬 《 Hello 》 를 붙이고 되돌이값 
을 돌린다. 


개발자들은 일반적으로 명세서가 결정되면 메쏘드의 작성을 인차 하고싶어한다. 사 
실 지금 만들려는 메쏘드는 명세서가 단순하기때문에 메쏘드본체를 직접 쓰기 시작한다 
고 해도 지 장은 없을것 이 다. 그러 나 여 기서는 시 험을 병 행하여 메쏘드본체를 만들어 보 
기로 한다. 

그런데 빈 getGreeting 메쏘드만 써넣으면 Eclipse 의 Task 보기에 《 String 형의 결 
과를 되돌릴 필요가 있다.》라는 경고통보가 표시된다. 이것을 피하기 위하여 림시로 메 
쏘드에 《return null ； } 라고 써놓는다. 
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목록 4-1. 처음에 고의적으로 실패하는 례 ( Hello . java ) 

package sample.hello； 
public class Hello { 

public String getGreeting( String name ) { 
return null； 


시험구동프로그람을 작성하기로 한다. 우선 [Package Explorer] 에 있는 
sample, hello 패 키 지 를 선택 한 다음 지 름차림 표를 연다. 다음 [New] ᅳ [JUnit Test 
Case] 를 선택하여 [New JUnit Test Case] 대 화칸을 연다. [Name] 본문칸에 
《HelloTest》 라고 입 력 하고 [Which method stubs would you like to create?] 의 
[constructor()] 를 선택 한다. 다음 [Finish] 단추를 찰칵한다(그림 4-1). 


JUnit Test Case 

Select the name of the new JUnit test case. You have the options to specify 
the class under test and on the next page, to select methods to be tested. 






Source Folder: 
Package: 


SampleChap4.1/src 

Browse... 

sample, hello 

Broyvse... 


Name: HelloTest 


Superclass: j u nit.framework .T estCase 


Browse... 

Which method stubs would you like to create? 

□ public static void main(StringD args) 



□ 

，， H 


□ setUpO 

□ tearDownO 

0jconstructorO ： 




Class UnderTest: 


Browse... 


Rnish 


Cancel 


그림 4-1. 시험쿄드의 작성 

목록 4-2 가 시험코드이다. 시험경우인 HelloTest 클라스는 TestCase 클라스를 계승 
한다. 또한 구성 자는 String 형의 인수를 하나 취하고 상위클라스 (super class) 의 구성 
자에 넘 기 고있 다. 이 구성 자는 시 험 경 우작성 의 조수를 리 용하면 자동작성 된 다. 

시험경우인 HelloTest 클라스에 메쏘드 《public void testGetGreeting() throws 
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Exception 》 를 추가한다. 여기서 메쏘드의 앞머리에 test 라는 문자렬을 추가해야 한다는 
데 주의해 야 한다. 이것을 추가하지 않으면 시험경우 실행할 때 시 험 경우로 인식되지 않 
는다. 또한 시험경우 메쏘드의 되돌이값은 void 로 한다. 시험 경우를 서술할 때 되돌이 
값이 없다고 생각해도 무방하다. 마지막으로 throws Exception 은 례외 가 일어난 경우 
에 Eclipse 의 [ JUnit ] 보기에 례외정보를 현시하기 위해서이다. TestCase 클라스에는 시험 
용메쏘드가 여 러개 준비되 여 있다. 그중에서 가장 많이 쓰는것 이 assertEquals 메쏘드이 다. 

이 메쏘드의 형식은 다음과 같다. (인수의 순서는 바물수 없다.) 
assertEquals ( 구하려는 결과，실지로 메쏘드를 호출한 결과) 

목록 4_2코드에서도 assertEquals (구하려는 결과: String , 메쏘드호출: String ) 의 
형식을 리용하고있다. Hello 클라스의 getGreeting 메쏘드의 명세서는 앞에서와 갈으므로 
구하려는 결과는 《Hello World ) 라는 문자렬로 된다. 

JUnit 가 제공하는 메쏘드는 표 4-1 과 같다. 이 장에서는 실지 시험경우에 자주 사 
용하는 assertEquals 메 쏘드를 중심 에 놓고 해설 한다. 

목록 4-2. 시험쿄드 ( HelloTestJava ) 

package sample . hello ； 
import sample . hello . Hello ； 
import junit . framework . TestCase ； 


public class HelloTest extends TestCase { 

// 이 구성 자는 JUnit 의 시험경우작성조수에 의하여 자동생성된다 
/** 

* Constructor for HelloTest . 

* Qparam argO 
*/ 

public HelloTest (String argO ) { 
super ( argO ) ； 

} 

// TestCase ① : 메쏘드이름의 앞머 리에는 반드시 “ test ” 를 단다 
public void testGetGreeting () throws Exception { 

Hello hello = new HelloO ; 

/* 

* Hello 클라스의 String getGreeting ( String literal ) 은 

* “ Hello ” 문자렬 을 인수의 문자렬앞에 붙여 서 되 돌리 는 메 쏘드 
*/ 

assertEquals ( “Hello World ” ， hello . getGreeting ( “ World ” )); 
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시험경우 즐라스의 이름과 관리방법 

시험경우의 클라스이름짓기규칙에 대해서는 일정한 론의가 있다. 례하면 앞의 
실례 에서는 《 HelloTest 》 라는 이름을 시험 경우에 붙이 고있다. 그러 나 « TestHello » 
라는 이름을 붙이는것 이 더 좋다고 하는 사람도 있다. 

이름을 다는 문제는 개발자에 의해 결정되는 문제이지만 시험경우 클라스를 넣 
는 등록부를 프로젝트안에 만들고 시험경우만을 넣는 경우에는 머리에 Test 를 불이 
는것보다 꼬리 에 Test 를 붙이는쪽이 혼돈하지 않아서 좋을것 이 다. 반대 로 시험경우 
와 시험대상클라스를 프로젝트안의 같은 등록부에 넣는 경우에는 머리에 Test 를 붙 
이는 쪽이 시험경우이라는것을 알아보기 쉬워질수 있다. 단지 이름의 첫머리에 고가 
불은 클라스가 있는 경우에는 그 클라스가 시험경우클라스와 혼돈되기 쉽다. 

일반적 으로 원천을 src 등록부에，시험경우는 test 등록부에 넣 고 따로따로 관리 
하는 방법 이 있다. 이 렇게 하면 프로젝트안에서 서 로 다른 등록부에 의하여 관리되 
고있어도 같은 패키지로 취급할수 있으므로 패키지내유효범위의 메쏘드도 시험이 가 
능하게 된다. 

프로젝트안의 서로 다른 등록부에서 시험대상코드와 시험코드를 갈라내는 방법 
에 대 해서는 앞으로 설명한다. 


4.3.2. 고의적으로 실패시키는 경우 

목록 4_2와 같이 시 험 코드를 작성 한 다음 [Package Explorer ] 안의 
HelloTest . Java 를 선택한 상태에서 지름차림표를 열고 [ Run ] —[1 Junit Test ] 을 선택 
한다. 그러면 시험경우가 실행된다. 목록 4-2 와 같이 원천코드를 작성한 경우 메 쏘드의 
삽입 이 불완전하므로 시험은 분명 히 실패한다(그림 4-2). 만일 시험 에서 성공했다면 다 
른 시험이 진행될 가능성이 있다. 

처 음에 고의적 으로 실패시키는 리유는 자기 가 진행 하고있는 시험경우의 클라스가 목 
적하는 경우인가를 확인하기 위해서 이 다. 실패해 야 할 시험 이 성공하거 나 원래의 의도와 
는 다른 오유통보가 출력될 때 에는 거의나 다른 시 험을 실행 하였기때 문에 그러한 결과가 
현시 된것이다. 

현시된 [ JUnit ] 보기의 [Failure Trace ] 을 보면 [ expected : ] 에는 《Hello World 》 
라고 표시되고 [but was :] 에는 《 null 》 이라고 표시 되여 있다(목록 4-3). 즉 Hello 
World 라는 문자렬을 결과로 기대했는데도 실지 결과는 null 이였기때문에 시험이 실패 
했다는것을 보여주고있다. 이러한 실패를 JUnit 에서는 고장 ( Failure ) 이라고 부론다. 
JUnit 에서 시험의 실패는 고장과 오유 ( Error ) 의 2가지로 갈라본다. 고장은 예견한 결 
과와 실지 로 얻 은 결과가 다른 경우에 일 어난다. 한편 오유는 예견하지 않은 례외 나 오 
유가 시험경우의 실행중에 발생한 경우에 일어난다. 
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목록 4-3. 실패 


그림 4-2. 시험의 실패 


junit . framework . ComparisonFailure ： expected:〈Hello World〉but was ：< null > 

4.3.3. 고의적으로 성공시키는 경우 

다음 단계에서는 고의적으로 시험을 성공시킨다. 결과 다음과 같은 효과를 얻을수 
있 다. 

1. 코드에 대 한 믿음감을 가질수 있다. 

2. 조금씩 메 쏘드의 삽입 을 진행할수 있 다. 

3. 오유 ( bug ) 의 발생 이 적 어지며 순조롭게 진행할수 있다. 

우에서 렬거한 1.~3.의 효과는 서로 밀접히 련관되여있다. 시험구동프로그람의 개 
발방법 에서 는 조금씩 삽입 하고 조금씩 시 험하는 방식을 취 한다. 고의 적 으로 성 공시키 는 
방법 이 바로 메 쏘드를 증분식 ( incremental ) 으로 삽입 해 가는 첫 공정 으로 된다. 또한 조 
금씩 시험과 삽입을 반복함으로써 삽입시 오유의 발생원인이 적어지고 순조롭게 코드작 
성을 진척시킬수 있다. 또한 시험을 실행하는 과정에 푸른띠가 나와있는 한 자기가 코드 
를 작성해가는 방향이 틀리지 않는다는것을 확인할수 있으므로 침착하게 코드작성을 진 
행할수 있 다. 

목록 4-4 가 고의 적 으로 성 공시 키는 경 우에 대 한 실례 이 다. 시험경우는 Hello 
World 라는 결 과를 기 대 하고있 다. 목록 4-4 에 서 는 고의 적 으로 성 공시 키 기 위하여 
《Hello World 》 라는 문자렬만을 되돌리는 메쏘드를 삽입하고있다. 이제 다시 시험경우 
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를 실행해본다. 그림 4-2 에 있는 전번시험의 재실행단추를 찰칵하면 간단히 시험을 재 
실행할수 있다. 시험경우를 실행하면 그림 4-3 과 같이 푸른띠 가 나오고 시험은 성공한 
다. 실패하는(빨간띠가 나오는) 경우에는 다른 시험경우를 실행하고있지 않는가를 검사 
해 본다. 

Eclipse 3. 0부터 는 《 Failure Trace : “ junit . framework . ComparisonFailure : 
expected . ..》 를 두번찰칵하면 기대 한 값과 결과를 비 교할수 있는 [Result Compare ] 
창문이 열리게 되 였으므로 이 러한 경우에 리용하면 편리할것 이 다. 

목록 4-4, 고의적으로 성공시키는 실례 ( Hello . java ) 

package sample . hello ； 

public class Hello { 

//고의 적 으로 성 공시 키 기 위하여 “Hello World ” 

//라는 문자렬 만 되 돌리 는 메 쏘드를 작성한다. 
public String getGreeting ( String name ) { 
return “Hello World ” ; 



그림 4-3. 고의적으로 성공시킨 경우 
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4.3.4. 메쏘드의 삽입과 재시험 

《Hello World 》 라는 결과만을 되돌리는 메쏘드는 실지 사용할만한 메쏘드가 못된 
다. 그래서 실지 사용할만한 실용적인 메쏘드를 삽입한다. 이 getGreeting 메쏘드의 명세 
서는《인수로 문자렬을 받고 그 문자렬 앞에 Hello 라는 문자렬을 붙인다.》는 내용을 담 
고있 다. 코드를 목록 4-5 에 제 시한다. 

목록 4-5. 실용적인 메쏘드의 삼입 ( Hello . java ) 

package sample . hello ； 
public class Hello { 

public String getGreeting ( String name ) { 
return “ Hello ” + name ； 


시험을 실행시켜보면 성공할것 이며 실패할 때 에는 오유원인을 찾아보아야 한다. 그 
러 나 성 공해도 고의 로 성 공시키 고있기때문에 다른 경우 ( “Hello World ” 이외의 경우) 
에도 성공되는가가 문제로 된다. 

그래서 시험경우를 바꿔써도 삽입할수 있는가를 검증하기로 한다. 수정한 시험경우 
를 목록 4-6 에 제시한다. 여기서 주의를 돌려야 할것이 해설문에서 《2단계시험》이라고 
쓴 부분이다. 먼저번 시험에서는 《 HelloWorld 》 라는 문자렬의 검사만을 하였다. 이번 
에는 하나 더 《Hello Java 》 라는 문자렬에 대응가능한가를 검사하고있다. 이 2개의 례 
로 메쏘드가 정상적으로 삽입되 였는가를 기본적으로 검사할수 있다. 이처 럼 현시할 내용 
이 하나인 경우 (《 HelloWorld 》) 만이 아니라 여러개인 경우 (《 HelloWorld 》 와 《Hello 
Java 》) 를 써서 시험경우메 쏘드를 서술하는 방법 을 삼각측량 ( Triangulation ) 또는 여 러 
단계시험 이 라고 한다. 

목록 4-6. 시험경우의 수정 ( HelloTest . java ) _ 

public void testGetGreeting () throws Exception { 

Hello hello = new HelloO : 

// 1 단계시험 

assertEquals ( “Hello World ” ， hello . getGreeting ( “ World ” ) ) ； 

// 2 단계시험 

assertEquals ( “Hello Java ” ， hello . getGreeting ( “ Java ” ) ) ； 
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4.3.5. 시험경우와 삽입메쏘드의 약간한 수정 

삽입코드를 보면 getGreeting 메쏘드가 Hello 클라스의 내부상태에 의존하지 않는다 
는것을 알수 있 다. 즉 이 메 쏘드의 사용자는 getGreeting 메 쏘드를 사용할 때 일일히 
Hello 클라스의 구체례를 생성할 필요가 없다. 그러므로 삽입메 쏘드에 static 열쇠어를 붙 
여서 클라스메 쏘드화한다(목록 4-7). 그 다음 재시 험을 진행해본다. 


목록 4-7. 메쏘드의 수정 ( Hellojava ) 

package sample . hello ； 
public class Hello { 

// 클라스메 쏘드로 변경하였 다. 

public static String getGreeting ( String name ) { 
return “ Hello ” + name ； 


일단 시험은 성공하지만 시험코드가 Hello 클라스의 구체례를 생성하고 그 구체례로 
부터 static 메쏘드를 호출하고있는것은 문제가 있다 (Eclipse 의 콤파일러의 기정설정에서 
는 경 고가 나오게 되 여있 다) . 왜 냐하면 구체 례 로부터 static 메 쏘드를 호출하는것 자체 에 
는 오유가 없으나 후에 이 코드를 읽 는 사람이 이 메 쏘드를 구체 례메 쏘드로 잘못 리 해할 
가능성이 있기때문이다. 즉 구체례의 내부상태에 의존하는 메쏘드라고 생각할수 있다. 
이러한 일이 없도록 하자면 코드삽입자가 클라스메쏘드를 사용하고 있다는것을 명시해놓 
을 필요가 있다. 개선한 시험경우의 코드를 목록 4-8 에 제시한다. 

목록 4-8. 개선된 시험경우 ( HelloTest . java ) _ 

// getGreeting 메쏘드를 클라스메쏘드로서 호출하도록 변경 
public void testGetGreeting () throws Exception { 

// 1 단계시험 

assertEquals ( “Hello World ” ， Hello . getGreeting ( “ World ” ) ); 

// 2 단계시험 

assertEquals ( “Hello Java ” ， Hello . getGreeting ( “ Java ” ) ) ； 
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4.3.6. 시 험 구동에 의한 메 쏘드삽입 순환 

그림 4-4 에 서 시 험 구동에 의한 메 쏘드삽입순환을 보여 주었 다. 이 그림 에 서 특히 중 
요한것 은 [대 상메 쏘드의 수정 ] ᅳ [시 험경 우의 수정 ] 의 순환이 다. 이 순환은 작성 자가 메 
쏘드의 코드를 완전히 작성할 때까지 계속한다. 메 쏘드의 수정 에서는 제7장에서 소개하 
는 개 편의 수법 을 적 용하면 순조롭게 수정할수 있 다. 

이 그림 에서는 시 험경우의 서 술을 먼저 써놓았지만 경 우에 따라서는 삽입메쏘드를 
먼저 쓴 다음에 시험메쏘드를 서술해도 무방하다. 여기서 중요한것은 삽입메쏘드와 시험 
메 쏘드 쌍방의 서 술을 병 행하여 진행하는것 이 다. 특히 론리 가 복잡하여 비 교적 삽입 이 
힘든 메쏘드에서는 그림과 같은 순환을 리용하는것 이 매우 좋다. 물론 지금 취급하고있 
는것 처 럼 간단한 메 쏘드의 경 우에 는 처 음부터 메 쏘드를 삽입해 도 된 다. 



그림 4-4. 시험구동에 의한 메쏘드삼입순환 
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제4절. 시험경우의 본격적인 작성 

여기서는 보다 실용적인 례를 들어 시험경우를 서술한다. 

4.4.1. 원천서류철의 생성 

처음에 취급한 《Hello World 》 의 례에서는 시험경우의 클라스와 원천코드의 클라 
스를 같은 등록부의 같은 패키지에 넣었다. 그러나 실지개발에서는 시험경우의 등록부와 
원천코드의 등록부를 갈라써 야 할 때 가 있다. 그렇 게 하기 위한 절 차는 다음과 같다. 

SampleChap 4. 1 프로젝 트를 선택 한 상태 에서 지 름차림 표를 열 고 [ New ] — [Source 
Folder ] 을 선택한다. 그리 고 《 test 》 라는 이 름으로 등록부를 생성한다(그림 4-5). 여 기 
서 문제로 되는것은 메쏘드의 유효범위가 패키지유효범위인 경우 같은 패키지에 시험클 
라스가 없으면 시험 이 불가능하게 된다는것 이 다. 그러 나 이제부터 설명하는 절차를 따르 
면 문제가 없다. src 등록부에 있는 패키지 ( sample.hello 패키지)와 같은 이름의 패키지 
를 test 등록부에 주가한다(구체 적 인 방법 은 제 3장까지 의 내 용을 참조할것 ). 이 렇 게 하면 
Java 로 관리하는 이름공간이 같아지므로 패키지유효범위의 메쏘드도 시험할수 있게 된다. 


SoyrC« f^kSer 

Add a Mckr 



그림 4-5. 새 원천서류철의 생성 

4.4.2. 견본프로그람의 설정 

그림 4_6과 같이 SampleChap 4. 2프로젝 트를 작성 하려 고 한다. 
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티■■선 SampleChap4.2 

□- 0 src 

白-. 0 sample.hello 

El [Ti DisplayObject.java 
El- Hi Employee.java 
El- [Jj EmployeeMap.java 
E [Jj EmployeeMapFactory. java 
E- 臣] Hello.java 
El- [£j HelloEmployee.java 
[+] [Ij XmlUtil.java 
十 豆 ]RE System Library [jre 1.6.0] 

B (3 test 

- sample.hello 

+ jj EmployeeMapFactoryTest:,java 
+ [7i HelloTest-java 

十 JUNIT_HOME/junil:.jar - D:WedipseWConripanero_kpWC 
_ emplo^ee.xml 


그림 4-6. 견본프로그람의 등록부구성 


몇가지 XML 용어 

앞으로 XML 용어를 써서 설명을 하여야 하기때문에 가장 기초적인 XML 용어에 
대하여 해설한다. 아래에서는 그림자부분이 용어에 대응하고있다. 

• 요소 ( element ) 

< name > 김강철 </ name > 

• 요소이름 (element name ) 

<| iam ^> 김강철 </ nam |> 

• 태그 ( tag ) 

< name > 김강철 </ name > 

• 요소내용 (element content ) 

< name > 김 강철 |</ name 〉 

• 속성 ( attribute ) 

〈Employee id = “01”〉 

• 속성 이 름 (attribute name ) 

〈Employee ■ = “01” 〉 

• 속성 값 (attribute balue ) 

〈Employee id = “01” 〉 
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4.4.3. 견본프로그람을 리용한 시 험 경우의 작성과 메 쏘드의 삽입 
여기서 시험경우의 작성례로 리용하려는것은 EmployeeMapFactory 클라스의 
public EmployeeMap createEmployeeMapO 메 쏘드이 다. 목록 4-9 를 보면 이 메 쏘드 
는 아직 삽입되 여있지 않다. 이 절에서는 이 메 쏘드를 시험구동방식 으로 삽입한다. 

먼저 메쏘드의 명세서를 확인한다. 명세서는 아래와 같다. 


이 메 쏘드는 XML 문서 를 읽어 들이 고 Employee 요소가 가지 는 속성이 름， ID 의 속 
성값과 Employee 클라스의 구체례를 한조로 하는 기 억기구조를 생성한다. 


이 메 쏘드는 점 차적 으로 삽입해 가기 로 한다. 

목록 4-9. createEmployeeMap 메쏘드가 삼입전의 EmployeeMapFact 아 y 클라스 

package sample . hello ； 


public class EmployeeMapFactory { 


private String directory Path ； 

/* 기정구성자는 다른 클라스로부터 보이지 않게 한다 */ 
private EmployeeMapFactory () { 


public EmployeeMapFactory (String directory Path ) { 
this , directory Path = directoryPath ； 


public EmployeeMap createEmployeeMap 0 { 
// 이 메쏘드를 삽입해 나간다 
return null ； 


이 createEmployeeMap 메쏘드를 삽입하기 전에 시험경우의 메쏘드를 정리해놓는다. 
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4.4.4. 시험용메쏘드의 개괄 

TestCase 클라스에는 표 4-1 에 제시한 메 쏘드가 있다. 여기서 가장 자주 리용되는 
메 쏘드는 

• assertEquals(String strl , String str 2) 

• failO 

인 2 개의 메쏘드이 다. assertTrue , assertFalse 메 쏘드도 있지 만 기 대 값과 메쏘드실 
행결과값의 차이에 대하여 표시해주지 않는다. 그러므로 기대값과 메쏘드의 실행결과의 
차이를 알려주는 assertEquals 메 쏘드를 사용하는 경우가 많다. 

문자렬을 되돌이 값으로 돌려 주는 메 쏘드에 대 해서는 JUnit 가 많은 비중을 차지한 
다. 그것은 assertEquals 메쏘드가 거의 문자렬을 취급하는 메쏘드이기때문이 다. 반대로 
문자렬 을 되 돌이 값으로 하지 않는 메 쏘드(례하면 GUI 나 웨 브관련의 메 쏘드 등)는 
JUnit 에서의 시험이 곤난한것으로 된다. 한편 웨브환경으서의 시험을 가능하게 하는 
HHPUnit , 자료기지환경에서의 시험을 간편하게 하는 DBUnit 등 JUnit 를 확장한 시 
험기 틀의 보급도 진척 되 고 있 다. 


표 4-1. 

TestCase 메쏘드 

메쏘드이 ■ 

설 명 

assertEquals ([인수1， 
인수 2] 혹은 

[인수1，인수2，인수 3]) 

기 대 되는 값인 [ 인수 1] 이 시 험하는 메쏘드의 결과값들인 
[ 인수2]，[ 인수 3] 과 같은가를 판정한다. 같을 때 에는 시 
험은 성공한것이다. 또한 기대값과 결과값이 같지 않을 때 
는 차이 점 을 지 적한다. 

assertTrue ([인수 1] 

혹은 [인수1，인수 2]) 

기대되는 값 [ 인수 1] 이 시 험하는 메쏘드의 결과값인 [ 인 
수 2] 와 같은가를 판정한다. 같을 때는 시험 은 성공한것 이 
다. 그러 나 기 대값과 결과값이 같지 않을 때 차이 점 을 지 
적하지 않는다. 

assertFalse ([인수 1] 

혹은 [인수1，인수 2]) 

기대되는 값인 [인수 1] 이 시험하는 메쏘드의 결과값인[인 
수 2] 와 같은가를 판정한다. 같지 않을 때는 시험은 성공한 
것 이 다. 그러 나 기 대값과 결과값이 같지 않을 때 차이 점 을 
지 적하지 않는다. 

fail ([인수 1]) 

시험을 실패시킨다. 

assertNull ([인수 1] 

혹은 [인수1，인수 2]) 

인수로 지적된 결과값이 null 인가를 판정한다. null 일 때 
시험은 성공한것이다. 

assertNotNull ([인수 1] 
혹은 [인수1，인수 2]) 

인수로 지적된 결과값이 null 인가를 판정한다. null 이 아 
닐 때 시험은 성공한것이다. 

assertSame ([인수 1] 

혹은 [인수1，인수 2]) 

인수로 지적된 객체 가 같은 객체인가를 판정 한다. 같을 때 
시험은 성공한것이다. 

assertNotSame ([인수 1 
혹은 [인수1，인수 2]) 

인수로 지적된 객체 가 같은 객체인가를 판정 한다. 같지 않 
을 때 시험은 성공한것이다. 
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4.4.5. 시험의 준비와 후처리 ( setup , tearDown ) 

TestCase 클라스에는 

public void setup () 
public void tearDown () 

이 라는 2 개의 메쏘드가 준비되 여있다. 이 메쏘드는 시험경우클라스안의 각 시험메쏘드 
의 개시와 완료때마다 호출된다. 

례하면 어떤 시험경우클라스의 시 험메쏘드 

testMethodl 0 
testMethod 2 () 

가 있다고 하자. 이 시험경우클라스안에서 setUp 메쏘드와 testDown 메쏘드를 삽입한 경우 

setUp () 
testMethodl 0 
tearDown () 
setup () 
testMethod 2 () 
tearDown () 

의 순서로 실행된다. 시험메쏘드의 개시와 완료에서 실행해야 할 어떤 처리가 있을 때에 
는 처 리 내용을 setUp 메 쏘드와 tearDown 메 쏘드에 삽입 하여 리용한다. 례 하면 자료기지 
와의 련결을 setUp 메쏘드로 받아놓고 tearDown 메쏘드로 반드시 련결을 닫는것과 같은 
사용실례를 들수 있다. 이 메쏘드들을 현재 실례에서는 사용하지 않는다. 

4.4.6. 편리한 문자렬화 ( toString 메 쏘드를 삽입 ) 

준비가 된 조건에서 EmployeeMapFactory 클라스의 createEmployeeMap 메쏘드 
의 삽입과 그 시험경우 (EmployeeMapFactoryTest 클라스의 testCreateEployeeMap 
메쏘드)를 서술하기 로 한다. 

시험대상으로 되는 createEmployeeMap 메쏘드의 되돌이값의 형이 EmployeeMap 
로 되 여있 다. 되 돌이 값인 EmployeeMap 클라스의 구체 례 로부터 종업 원의 ID 값을 열쇠 
로 하여 종업 원정 보를 표시하는 Employee 클라스의 구체 례 를 얻 을수 있 다. 그러 므로 시 
험방법은 종업 원의 ID 값을 열쇠로 하여 Employee 클라스의 구체례를 얻은 다음 기대한 
종업원정보인가를 확인하는 방법이 좋다. Employee 클라스의 구체례를 얻은 다음 기대 
한 결 과와 일 치 하는가를 평 가하자면 Employee 클라스의 Getter 메 쏘드를 써 서 매 번 
assertEquals 메 쏘드로 기대 값과 비교하면 된다. 
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목록 4-10. 도중에서 실패하는 경우 _ 

package sample , hello ； 

import junit . framework . TestCase ； 

public class EmployeeMapFactoryTest extends TestCase { 

I%% 

* Constructor for EmployeeMapFactoryTest . 

* Sparam argO 
*/ 

public EmployeeMapFactoryTest (String argO ) { 

Super ( argO ) ； 

} 

public void testCreateEmployeeMap 0 throws Exception { 

// 시험경우메쏘드를 서술한다. 

EmployeeMapFactory eFactory = new EmployeeMapFact 
ory ( “ employee . xml ” ) ； 

employeeMap eMap = eFactory . createEmployeeMapO ； 
Employee eOl = eMap . getEmployee ( “01” ) ； 

// ..… 


여기서 매번 Getter 메쏘드를 리용하여 비교하는 방법도 좋지만 Getter 메쏘드의 수 
가 많으면 코드가 복잡해진다. JUnit 에서 어떻게 assertEquals 메쏘드를 리용하는가가 
매 우 중요하다는것은 이미 강조하였다. 이 실례 에서처 럼 마당의 수가 많고 그에 비례하 
여 Getter 메 쏘드가 많아지 는 클라스의 구체 례 를 되 돌이 값으로 하는 메 쏘드를 시 험하는 
경우 다음과 같은 수법이 자주 사용된다. 


객체의 문자렬화형식을 써서 결과를 평가한다. 즉 toString 메쏘드를 써서 결과를 
평 가한다. 


모든 클라스는 직접적 으로나 간접적 으로나 java. lang.Object 클라스(아래 에서는 
Object 클라스로 략칭한다. )를 계 승하고있 다. 그리 고 Object 클라스는 toString 메 쏘드를 
삽입 하고있으므로 필 연적 으로 모든 클라스는 toString 메 쏘드를 삽입 하고있는것 으로 된 
다. 그러나 Object 클라스에서 정의하고있는 toString 메쏘드는 Java 가상기계가 할당한 
구체례의 ID 값을 표시 하기 만 한다. ID 값을 표시 하기 만 해서는 시험경우에서의 평 가에는 
쓸수 없다. 

그래서 Employee 클라스에서 toString 메쏘드를 재정의 (override) 하여 사용하기로 
한다. toString 메쏘드의 삽입례를 목록 4-11 에서 보여주었다. 
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목록 4-11. Employee 클라스에 추가한 toString 메쏘드 ( Employee . java ) 

* 이 객체를 문자렬화한다. 

*/ 

public String toString () { 
return “[” 

+ id + “，” 

+ name + 

+ role + “，” 

+ telNumber + 

+ boss 



이 toString 메쏘드를 사용하면 객체는 [김영철，실장，999888777， null ] 와 같은 
결과를 되돌린다. 여기서 실례로 든것은 Employee 클라스가 보존하는 마당값을 반점으 
로 구분하여 라렬한것이지만 XML 형식으로 결과를 되돌리는것도 좋은 방법이다. 목록 
4-12 에 객체의 문자렬화형식 을 리 용하여 작성한 시험경우를 보여 주었다. 

목록 4-12. 객체의 문자■화를 리용한 시험경우 ( EmployeeMapFact 아 yTest . java ) _ 

package sample , hello ； 

import junit . framework . TestCase ； 

public class EmployeeMapFactoryTest extends TestCase { 

/** 

* Constructor for EmployeeMapFactoryTest 

* Sparam argO 
*/ 

public EmployeeMapFactoryTest (String argO ) { 
super ( argO ); 


// Employee 클라스의 toString 메쏘드를 리용한 시험경우의 삽입 
public void testCreateEmployeeMap 0 throws Exception { 

EmployeeMapFactory eFactory = new EmployeeMapFactory 
( “ employee . xml ” ) ； 

EmployeeMap eMap = eFactory . createEmployeeMapO ； 
Employee eOl = eMap . getEmployee ( “01” ); 

// 문자렬화하고 검사 

assertEquals ( “[01， 김영철， 실장， 999888777， null ]” ， 
eOl . toStingO ) ； 
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4.4.7. 삽입의 완성 

시험경우 메쏘드를 삽입했으므로 고의적으로 성공시키는 경우에 대하여 보기로 한다. 

목록 4-13. 고의적으로 성공시키는 메쏘드의 삽입田 mployeeMapFact 아 y . java ) _ 

package sample , hello ； 
import java . io . File ； 
import java , util . HashMap ； 
public class Emp 1 oyeeMapFactory { 

/* 기정구성자는 다른 클라스로에서 보이지 않게 한다. */ 
private EmployeeMapFactory () { 

} 

private String directoryPath ； 

public EmployeeMapFactory (String directoryPath ) { 
this . directoryPath = directoryPath ； 


// 고의적 으로 시험을 성공시키는 메쏘드의 삽입 
public EmployeeMap createEmployeeMap 0 { 

java . util . Map employ eeMap = new HashMap 0 ； 

File xmlFile = new File ( directoryPath ) ； 

Employee emp 

= new Employee ( “01” ， “김영철” ， “실장” ， 999888777); 

employeeMap . put ( “01” , emp ) : 

return new EmployeeMap ( employeeMap ) ； 


시험의 시작단계에서는 이처럼 메쏘드를 간단히 삽입함으로써 이후의 본격적인 코드 
작성 에 쓸만한 메 쏘드의 삽입방향을 가늠할수 있 다. 즉 

XML 문서 로 서 술되 여있는 Employee 요소의 수만큼 Employee 클라스의 구체 례 를 
생성한다. 생성한 구체례로부터 종업원 ID ( employeelD ) 를 하쉬열쇠로 하여 하쉬값령역 
(hash map ) 에 넣는다. 마지막으로 그 하쉬값령역을 Employ eeMap 클라스의 구성자인 
수로 하여 객체 를 생성한다. 

DOM 나 SAX 와 같은 XML 의 API 에 익 숙되 여 있지 않은 경 우 코드작성 이 힘 들것 이 
다. 여기서는 XML 문서로부터 요소내용이나 속성값을 꺼내고 Employee 클라스의 구체 
례를 생성하는 처리가 어떤 틀거리를 가지는가를 리해하면 된다. 한번도 써본적이 없는 
API 를 쓸 때는 이처 럼 시험을 진행하면서 삽입하면 속도는 떨어지지만 정확히 리용할수 
있 다. 
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4.4.8. 여 러단계 시 험 

마지 막으로 여 러 단계 시 험 을 진행 하여 실지 로 createEmployeeMap 메 쏘드가 삽입 되 
여있는가를 확인한다. 삽입 례 는 목록 4-14 와 갈다. 


목록 4-14. 여러단계시험을 틍한 시험경우의 실현 _ 

public void testCreateEmployeeMap 0 throws Exception { 

EmployeeMapFactory eFactory = 

New EmployeeMapFactory ( “ employee . xml ” ); 
EmployeeMap eMap = eFactory . createEmployeeMap 0 : 

Employee eOl = eMap . getEmployee ( “01” ) ； 

// 문자렬화하고 검사 

assertEquals ( “[01，김영철，실장，999888777, null ]” , eOl . toStringO ) ； 
// 여 러단계 시 험 1 

Employee e 02 = eMap . getEmployee ( “02” ); 
assertEquals ( “[02， 백남진，설계원，111122223，” 

+ “[01， 김영철，실장，999888777， null ]” ， e 02. toStringO ) ； 

// 여 러단계 시 험 2 

Employee e 03 = eMap . getEmployee ( “03” ); 
assertEquals ( “[03， 김철혁，기사，666，” 

+ “[01， 김영철，실장，999888777， null ]” ， e 03. toStringO ) ； 


이상으로 시험 경우가 완성되 였다. 시험경우를 실행하여 륵색띠 가 나타나는가를 확인 
해 본다. 

4.4.9. 시험을 묶어서 실행 

지금까지 작성한 시험경우를 묶어서 실행하기 위한 방법에 대하여 소개한다. 

[Package Explorer ] 안의 [ SampleChap 4.3] 프로젝 트아래 의 [ test ] 등록부에 있는 
[ sample . hello ] 패키지를 선택하고 오른쪽찰칵한다. [ New ] ᅳ [ Other ] 를 선택하여 현시 
되는 대화칸의 [ Java ] —[ JUnit ] 에서 [JUnit Test Suite ] 를 선택한다. [ Next ] 단추를 찰 
칵하고 시 험 묶음의 이 름을 《 AllTests 》 라고 입 력한다. 마지 막으로 
EmployeeMapFactoryTest 와 HelloTest 를 선택 하고 [ Finish ] 단추를 찰칵한다(그림 
4-7). 이상의 절 차에 의하여 시 험경우를 묶은 AllTests 라는 이름의 시 험묶음클라스를 
Eclipse 가 자동생 성하여 준다. 
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Q 

□ E 三日 


그림 4-7. 시험묶읃작성 

이 시 험 묶음 (AllTests) 을 실 행하는 단계 는 아래 와 같다. 

[Package Explorer] 안의 AllTests. java 를 오른쪽찰칵— [Run]— [JUnit Test] 
을 선택하여 실행한다. 실행하면 프로젝트안의 모든 시험경우가 자동실행된다. 


Eclipse ! 0에서 시험경우의 처리 

Eclipse2.0 까지의 판본에서는 시험경우들을 묶어서 실행 하기 위한 시험묶음을 
작성할 필요가 있 었 다. 그러 나 Eclipse2.1 에 서 부터 는 자동적 으로 프로젝 트안에 존 
재 하는 시험 경우에 대 하여 모두 실행하게 되 였다. 

Eclipse3. 0에서도 마찬가지 이 다. [Package Explorer] 안의 시험을 진행 하려는 
프로젝트이름에 유표를 맞춘다. 다음으로 유표를 맞춘 프로젝트이름에서 오른쪽찰칵 
ᅳ [Run] ᅳ [JUnit Test] 을 선택하면 프로젝트안의 모든 시험경우를 실행한다. 
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제5절. Eclipse 를 사용한 시험작성의 요점 

JUnit 를 사용하면 여 러 가지 시 험 경우에 대 하여 작성할수 있다. 례하면 JDBC 의 대 
용체 (stub) 를 써서 실지 로 자료기지와 접속하지 않아도 시험을 진행할수 있는 환경을 
만들어놓고 JUnit 를 쓸수도 있다. 이러한 JDBC 와 같은 대면부의 간단한 대용체를 일반 
적 으로 위조객체 (mock) 라고 부른다. 시험경우를 작성 함에 있어서 위조객체를 활용하는 
것 이 매우 중요하다. 

또한 JUnit 를 잘 리용하려면 경험과 부단한 학습이 동반되여야 한다. 시험의 문제 
포괄정도와 견고성을 고려하려면 쏘프트웨어공학에서의 시험기법에 익숙해야 한다. 
JUnit 의 우점은 초기의 학습에서 시험에 필요하다고 인정되는 기술중에서 60% 정도 소유 
할수 있는것이다. 또한 JUnit 를 리용하면 목표를 작게 분할하고 JUnit 를 적용할수 있는 
것부터 시작할수 있다. 


JUnit 의 효능 

JUnit 가 편리한것은 사실이고 품질도 1.25 배〜 1.6 배정도로 높아지지만 JUnit 를 
리 용하지 않고 그냥 코드를 작성할 때 에 비 하여 공수는 2. 5 배 정 도로 늘어난다. 개 
편할 때 매우 편리 하고 Junit 를 사용한 회귀시험 에 의하여 오유를 막을수 있다는 우 
점과 함께 공수가 많이 든다는 결함도 있다는것을 알아야 한다. 

일반적으로 틀거리개발과 같은 개발인원수가 작고 자주 변경할 필요가 있는 프 
로젝트에서는 JUnit 의 효과가 크며 업무체계와 같은 개발인원을 많이 요구하는 프로 
젝 트에서는 공수문제를 무시할수 없기때 문에 일부 중요 부문에 만 적 용하는것 이 좋다. 

이것은 소규모고품질체계를 개발할 때는 일정한 능력이상의 많지 않는 인원이 
충분한 정보교환을 보장하는것 이 가장 효과적 이 라고 주장하는 XP 수법의 요구와 일 
치한다. 한편 대규모업무프로젝트에서는 우선 많은 인원을 확보해야 하기때문에 자 
연히 개발성원들의 기능수준이 서로 같지 않으며 따라서 의사소통을 충분히 보장하 
기 가 힘 들어 진다. 그리하여 이 와 같은 대 규모프로젝 트에 서 XP 수법 을 적 용하기 가 곤 
난하다. 
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제5장. 오유수정 

4 장에서 설명한바와 같이 JUnit 를 사용하여 시 험 구동개 발을 진행하는것 으로 오유가 
적 은 효률높은 프로그람을 작성할수 있 다. 그렇 지 만 처 음부터 오유가 전혀 없는 프로그 
탐을 작성할수는 없다. 특히 개발과정에서는 부주의나 실수로 인하여 오유가 나타나게 
되 며 다음과 같은 문제 들이 발생할수 있 다. 

• 시험이 실패하였으나 Junit 의 통보문만으로는 원인을 잘 알수 없다. 

• 시험에서 빠진 검사항목이 있어 프로그람이 예상외의 동작을 한다. 

• 실행할 때 례외 가 발생하여 프로그람이 갑자기 정지해 버린다. 

이러한 때에는 오유수정프로그람을 사용한다. Eclipse 에는 오유수정을 지원하는 여 
러가지 기 능이 갖추어 져 있 다. 


제1절. 오유수정프로그람 

5.1.1. 오유수정프로그람의 기동 

오유수정프로그람을 기동하는 순서는 프로그람의 실행순서와 거의 같다. 

다음과 같은 3 가지 방법이 있다. 

1. 차림 표띠 에 서 [Run] ᅳ [Debug History] 을 선택하여 현시 되 는 대 화칸에 서 기 정 
설정 을 그대 로 선택한다. 

2. [Package Explorer] 보기 에 서 오유수정 하려 는 클라스나 서 류철을 선택 하고 차 
림표띠에서 [Run] ᅳ [Debug As] 를 선택한다. 여기서 Java Application, Jav 
a Applet, JUnit Test, JUnit Plug-in test, Runtime Work Bench 중에서 
필요한것을 선택한다. 

3. 차림 표띠 에 서 [Run] ᅳ [Debug] 를 선택하면 현시 되 는 Debug 대 화칸(그림 5-1) 
에서 《 configurations: >목록의 필요한 항목을 선택한 다음 [Debug] 를 찰칵한다. 

그림 5-1 의 대화칸에서 기동구성의 종류별로 투시와의 련관을 맺어줄수 있다. 기정 
으로는 어떤 기동구성을 설정해도 오유수정프로그람을 기동하여 멈춤점 (break point) 에 
서 실행 을 중단하면 [Debug] 투시 로 설정 이 바뀌여 진다. 
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그림 5-1. 기동구성과 투시와의 관련설정 

차림 표띠 외 에 도구띠 의 [Debug] 단추(벌 레 모양의 아이 콘) 나 [Package Explorer] 
보기，또는 [Outline] 보기 를 오른쪽찰칵하여 현시 되 는 지 름차림 표로부터 도 오유수정 프 
로그람을 기동할수 있다. 또한 오유수정프로그람의 기동과 프로그람의 실행 에서 같은 기 
동구성 을 리 용할수도 있 다. 기 동구성 의 자세한 내 용에 대 하여 서 는 3 장의 제 3 절을 참조 
하기로 한다. 

실지 오유수정프로그람을 기동하여 보기로 한다. Eclipse 를 기동하고 SampleChap5 프로 
젝트를 연다. 여 기서는 오유수정 용으로 새롭게 기동구성 을 작성해 본다. 

[Java] 투시 로 절 환하여 차림 표띠 에 서 [Run] —[Debug] 을 선택 하여 Debug 대 화칸 
을 연다. 대 화칸의 왼쪽에서 [ Java Application] 을 선택 하여 [Perspectives] 래 브의 
[Debug] 의 내 리 펼침목록에서 [Debug] 가 선택되 였는가를 확인한 후 [New] 단추를 찰 
칵한다. 다음 대화칸의 오른쪽에 있는 [Name] 에 《 Hello Employee Debug 》， 
[Project] 에 《 SampleChap5》 ， [Main Class] 에 《 sample.hello.HelloEmployee 》 
를 지 정 한다(그림 5-2). [Stop in main] 검 사칸을 선택 하여 놓으면 main 메 쏘드가 호출 
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되 는 곳에 서 스레 드가 중단된다. 이 검 사칸을 선택하여 [ Debug ] 단추를 찰칵한다. 투시 
를 절환하겠는가 하는 확인을 요구하는 대 화칸(그림 5 _ 3) 이 현시 되 는데 다음부터 는 이 
확인통보문이 필요없으면 대 화칸에서 [Remember my decision ] 검 사칸을 선택한다. 대 
화칸의 [ Yes ] 단추를 찰칵하여 오유수정프로그람을 기 동한다. 



그림 5-2. 오유수정 프로그람의 기동구성작성 


푠 = Confirm Perspective Switch 


均 


This kind of launch is configured to switch to the Debug perspective when Jt suspends. Do you want to switch to 
this perspective now? 


□ Remember my decision 



그림 5-3. 투시절환의 확인대화칸 
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5.1.2. [ Debug ] 투시 

오유수정프로그람이 기동하면 그림 5-4 와 같은 [Debug (오유수정)]투시가 열린다. 
[Debug] 투시에는 오유수정에 필요한 조작의 실행이나 정보의 참조에 해당한 보기들이 
있 다. 



그림 5-4. [ Debug ] 투시 

웃부분의 좌측에 있는것이 [Debug] 보기이다. [Debug] 보기에는 현재의 스레드 및 
탄창프레 임 (stack frame) 이 현시된다. 기동구성 에서 main 메쏘드에서 중단하도록 설정 
한 결과 스레드가 중단된것을 알수 있다. [Debug] 보기의 웃부분에는 단추가 있고 멈춤 
점에서 중단되는 스레드를 다시 열거나 실행중의 스레드를 일시 중단시킬수도 있고 완전 
히 정지시키는 조작이 가능하다. 오유수정 에서 중요한 걸음 (Step) 실행도 [Debug] 보기 
의 단추를 사용하여 진행된다. 오른쪽우에 [Variables] 보기， [Breakpoints (멈춤점)]보 
기가 있다. 이런 보기들에 대한 구체적인 내용은 후에 서술하겠지만 여기서는 변수값의 
확인이나 변경，멈춤점의 유효화，무효화 등이 진행된다. 

[Debug] 투시의 가운데부분에는 Java 편집기와 [outline] 보기가 있다. 멈춤점에서 
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중단하면 Java 편집 기 에 현재 실행 중의 원천코드가 표시 되 고 중단되 여있는 멈 춤점 의 위 
치가 화살표로 표시된다. 또한 멈춤점을 설정하지 않았으나 기동구성의 설정에서 [main 
에서 정지]를 선택하였으므로 주메쏘드 (main method ) 의 제일 첫 행에서 중단한다. 

아래부분에는 [ console ] 보기와 [ task ] 보기가 있다. 오유수정프로그람이 기동할 때 
에 기 동구성 에 서 JUnit 를 선택한 경 우는 [ JUnit ] 보기 가 추가된다. 

이 와 같이 [ Debug ] 투시 의 기 본적 인 보기 에 대 하여 소개하였 다. 실지 오유수정 에서 
는 이 런 보기 들을 사용하여 여 러 가지 조작을 진행한다. 지 금은 프로그람의 실행 이 중단 
된 상태 이지만 여 기서 [ Debug ] 보기의 [ Resume ] 단추 (그림 5_5) 를 찰칵해보면 중단되 
였던 스레드가 재시동되며 나머지 처리가 실행되게 된다. 결과 프로그람이 정상적으로 
완료된다. 


험선：:—、 


| » II m ^ 輪 


3. ^ 上 


-렷 


日 


T W HelloEmployeeDebug [Java Application] 

▽ ^sample.hello.HelloEmplovee at localhost:32780 
▽ # Thread [main] (Suspended (entry into method main in HelloEmployee)) 


: Hel I oEmpIoyee.main(String□) line: 18 


^/Companero-1.2/jdkl.6 t Cybin/java (Aug 12, 2005 1:07:20 AM) 


그림 5-5. [ Debug ] 보기 
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제2절. 멈춤점 


5.2.1. 멈춤점의 개요 

멈춤점을 설정하여 오유수정프로그람을 기동하면 멈춤점이 있는 위치에서 프로그람 
실행이 중단된다. 중단하고있는 동안은 그 시점에서의 변수값을 조사하고 식의 값을 평 
가하는 등 오유수정 에 필요한 정보를 얻을수 있다. 

Eclipse 에서 설정할수 있는 멈 춤점 을 표 5_1 에 주었 다. 


표 5-1. 멈춤점의 종류 

종류 설 명 

Line Breakpoint 메쏘드내의 원천코드행 에 대 해 설정하는 멈춤점 . 그 행의 코 

드를 실행하기직전에 실행을 중단시킬수 있다. 

Method Breakpoint 메 쏘드에 대 하여 설 정 하는 멈 춤점 . 메 쏘드의 불러 내 기 (입 구 

점)나 메 쏘드의 되돌림 (완료)에서 실행을 중단시킬수 있다. 
Watchpoint 마당에 대 하여 설정 하는 멈 춤점 . 마당의 호출이 나 마당에 로의 

대입 (변경)에서 실행을 중단시킬수 있다. 


Java Exception 례 외 의 형 을 지 정 하여 설 정 하는 멈 춤점 . 포착되 는 례 외 나 포 
Breakpoint 착되지 않는 례외를 버릴 때 실행을 중단시킬수 있다. 

Class Breakpoint 클라스를 지 정 하여 설 정 하는 멈 춤점 . 해 당한 클라스가 제 일 

처음으로 적재될 때 실행을 중단시킬수 있다. 


5.2.2. 행멈춤점의 설정 

[Package Explorer] 보기에서 《 SampleChap5 》프로젝트 — [src] 서류철 — 
[sample, hello] 패 키 지 를 전개 하여 EmployeeMapFactory. java 를 두번 찰칵하면 원천 
코드를 편집 기 에 현시 한다. LoadEmployee 메 쏘드의 가운데부분에 있는 for 문의 다음행 
에 《Node childNode = nodeListitem(i) : 》 라는 행 이 있는데 여기에 행멈춤점을 설정한 
다. 이행의 좌측에서 표식띠 (marker bar) 를 오른쪽찰칵하여 [Toggle Line Breakpoint] 
을 선택하면 그림 5-6 과 같이 표식띠 에 청 색의 동그란표식 이 붙여 진다. 이 표식 은 행 멈 
줌점이 유효하다는것을 나타낸다. 

설 정 한 행 멈 춤점 을 제 거 하려 면 행 멈춤점 의 표식 을 오른쪽찰칵하여 [Toggle Line Breakpoint] 
을 선택 한다. [Toggle Line Breakpoint] 이 아니 라 [Disable Breakpoint] 를 선택 하 
면 청색표식이 흰색표식으로 변경되여 일시적으로 행멈춤점이 무효로 된다. 사용할수 없 
게 된 행멈춤점도 [Debug] 투시의 [Breakpoints] 보기에서는 목록으로 현시되기때문에 
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멈춤점의 유효/무효를 자주 절환하려는 경우에는 없애버리지 않고 사용불가능으로 해놓 
으면 편리하다. 

사용불가능한 행멈줌점을 사용가능하게 하려면 행멈줌점표식을 오른쪽찰칵하여 
[Enable Breakpoint ] 를 선택한다. 여기서 설명한 멈춤점의 제거 및 사용가능/사용불가 
능의 절환조작은 설정시의 메쏘드멈춤점이나 감시점에 대하여도 똑같이 진행된다. 


r- 

1 

1 E m pJ aye eM ap F actory j av a 

□ 


f ■--■■' t ，—- 厂 i w -一*좌-厂 

士 田 param xmlLFile 

囚 



V 



•: . 

j ^ private java .util .Map loadEinploYee(FilG xmlPile) ( 




I java .util .Map einploYeeHap = new HashMap( ) : 




J XmlUtil xUtil = null; 



ᅵ 

| Document doc = null ; 




try { 




j xUtii = new XmlUtil()[ 



•: . 

{ doc = xUtil. createDocuiuent(xmlFile) ; 




1 } catcb (Exception e) { 




[ e.printStackrrace( ) : 

i 




j 

l Node node = doc. getDocuinentElement( ); 




| NodeList nodelist - node.getChildNades( ) : 



■ 

l for (int 1=0; i < nodeLIst.getLength( ) : I++) { 




jl Node ch[lldNade = nodeList. iteiti(i) ; 

— 


■1 

if (childNode.getNodeTypet ) == Node.ELEMENTSODE) { 



• 

String id = 




\ XinlUtil. getAttributeValue(childNode, "'id 11 ) : 




String name = 



!；i - 

| XinlUtil.getNodeValue( XinlUtil.getOnlyElementf(Element)* 




String role = 



::, 

| XmlUtil.getNodeValue( XmlUtil.getOnlyEleinentt(Element)! 



. 

j String telNumber - 




| XmlUtil.getNodeValuef XmlUtil.getOnlyEleinentf(Element)! 



:’ . 

String bossld = 




\ XinlUtil. getNodeValue( XmlUtil. get0nlyEleitient( (Element)( 




| Employee employee = 



후 :: 

[ Dew Employee(id, name, role, telNumber); 




\ eitiploYeeHap .put(id, employee) : 




Employee boss = (E]tiploYee)e]tiploYeeMap. get (bossld) : 




\ employee.setBoss(boss); 




} 

1 > 

0 


HI 1 IH 

一 1 


그림 5-6. 행멈춤점 


행 멈 춤점 의 표식 을 오른쪽찰칵하여 표시 되 는 지 름차림 표로부터 [break point 
property ] 을 선택 하면 그림 5_7과 같은 대 화칸이 현시 되 고 행 멈 춤점 의 자세 한 속성 을 
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설 정할수가 있 다. 이 대 화칸에 서 도 행 멈 춤점 의 사용가능/사용불가능을 절환할수 있 다. 
그러면 앞에서 설정된 행멈춤점 에 명중계수기 (hit counter ) 를 설정해본다. 그림 5_7의 
대화칸에서 [ common ] 을 선택 하고 [hit Count :] 검사칸을 선택한 다음 본문칸에 《2》 
를 입 력한다. 그러 면 두번째 로 그 행 이 실행 되 였을 때 만 멈 춤점 에서 스레드가 중단되 게 
된다. 이런 행멈춤점은 for 순환의 내부에 있기때문에 순환의 두번째 실행시에 중단되게 
된다 .([5.3.1. 멈춤점에서의 중단과 재개]에서 확인한다.) [ OK ] 단추를 찰칵하여 대화 
칸을 닫는다. 



그림 5-7. 행멈춤점의 속성설정 

그리 고 행멈 춤점 을 설정 혹은 제 거 하기 위 해서 는 편집 기 의 표식띠 를 두번 찰칵한다. 
설정과 제거만 있으면 이런 조작들이 간단하지만 사용가능/사용불가능을 절환하려면 앞 
부분에서 설명한 순서 가 필요하다는데 대 해 주의 를 돌려야 한다. 
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5.2.3. 메쏘드멈춤점의 설정 

메 쏘드멈춤점의 설정 은 편집 기의 표식 띠의 지름차림 표가 아니 라 차림 표띠의 [ Run ] 
혹은 [Package Explorer ] 보기나 [ Outline ] 보기의 지름차림표를 사용한다. 여기서는 
차림 표띠 를 사용하여 메 쏘드멈 춤점 을 설 정한다. 

1. [ Java ] 투시를 열고 [Package Explorer ] 보기에서 [ SampleChap 5] 프로젝트— 
[ src ] 서류철 — [ sample . Hello ] 패키지 — [ XmlUtil . Java ] 를 두번 찰칵하여 원천코 
드를 현시한다. 

2. [ outline ] 보기 에 서 createDocument ( File ) 메 쏘드를 선택 한다. 

3. 차림 표띠 에 서 [ Run ] — [Toggle Method Load Breakpoint ] 을 선택 한다. 

4. 원천코드의 메쏘드선언부에 메쏘드멈춤점의 표식 이 나타난다.(그림 5-8) 

결과 메쏘드멈춤점에 의해 메쏘드를 호출할 때 실행이 중단된다. 메쏘드멈춤점의 표 
식 을 오른쪽찰칵하여 [ break point property ] 을 선택한다. 이 때 현시 되 는 대 화칸에 서 
실행을 중단시킬수 있는 조건을 변경시킬수 있다. 



그림 5-8. 메쏘드멈춤점 


5.2.4. 감시점의 설정 

감시점의 설정도 차림 표띠의 [ Run ] 혹은 [Package Explorer ] 보기 나 [ outline ] 보 
기 의 지름차림 표를 사용한다. 여 기서 는 [ outline ] 보기를 사용하여 설정해본다. 

1 . [ Java ] 투시 를 열 고 [Package Explorer ] 보기 에 서 [ Samplechap 5] 프로젝 트— 
[ src ] 서 류철 — [ sample . Hello ] 패 키 지 — Employee . Java ] 를 두번 찰칵하여 원천 
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코드를 현시한다. 

2. [ outline ] 보기에서 name 마당을 오른쪽찰칵하여 현시 되는 지름차림표에서 
[toggle with Watchpoint ] 을 선택한다. 

3. 원천코드의 마당선언부에 감시점의 표식이 나타난다(그림 5-9). 


10혈 

/* 


package sample.hello; 

아** 

* ^author ASCII 


片 

V 

▽public class Employee implements DisplayObject { 


■ 


private String id; 
private String ISBBB : 
private String role; 
private String telNumber; 
private Employee boss; 

public Employee(String Id, String name, String role, 
this .id = id; 
this .name = name; 
this .role = role; 
this .telNumber = telNumber; 

} 

/* 

* @see sample.hello.DisplayObject#display() 

*/ 

public void displayt) { 

System.out.println( " =" + id); 

System.out.println(" =" + name) : 


__ 


String telNumber) 




hL 


그 因 


그림 5-9. 감시점 

감시점은 기정으로는 마당을 변경하거나 참조할 때 실행을 중단시킨다. 감시점표식 
을 오른쪽찰칵하여 [break point property ] 을 선택한다. 이 때 현시 되 는 대 화칸에서 실 
행을 중단시키는 조건을 변경시킬수 있다. 
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제3절. 오유수정프로그람의 실행 

5.3.1. 멈춤점에서의 중단과 재개 

그러면 5장의 제2절에서 설정된 멈춤점에서 실행이 중단되는가를 확인해보도록 한 
다. 차림표띠에서 [ Run ] ᅳ [ Debug ] 를 선택한다. 열려진 대화칸의 왼쪽에 이미 설정한 
HelloEmployeeDebug 의 기 동구성 이 있으므로 그것 을 선택한다. [5.1.1. 오유수정 프 
로그람의 기동]에서 오유수정 프로그람을 기동하였을 때 에는 [stop in main ] 에 선택을 하 
였으나 이 번에는 선택하지 않고 [ Debug ] 단추를 찰칵한다. 제 일 처 음의 멈춤점 에서 실 
행 이 중단되 고 [ Debug ] 투시 로 절환된다. 결국 이 미 설정한 메 쏘드멈 춤점 인 XmlUtil 클 
라스의 createDocument ( File ) 메쏘드의 제일 첫 행에서 중단된다(그림 5-10). 

d % * • 그 망 1 "、"병예게전미~ ——— 1 - ib ! x I 

터V I내! I인 R^j£|rt 발며 Mflc StirClt PrquLl g|in 법 Imiow Udp 

U 建 O * r i ^ :，;' 醫 ^ ᅳ 밖 & 公 * tw 예 ^ 



그림 5-10. 메쏘드멈춤점에 의한 중단 


중단된 스레드의 재개 나 정지 등의 조작은 [ Debug ] 보기의 도구띠단추를 사용한 
다.(그림 5-11) 단추는 3개 의 그롭으로 나뉘 여 져 있는데 왼쪽그롭에 스레 드의 
[ Resume ] , [ Suspend (중단)]， [ Finish ] 단추가 있다. 가운데 그롭에는 스레드실행을 위 
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한 3개 의 단추가 배 치 되 여있 다. [ Resume ] 단추를 사용하면 다음번 멈 춤점 까지 단번에 
실행해 버리지 만 걸음실행단추를 사용하면 원천코드상에서 한행 만 실행 하고 다시 실행 이 
중단된다. 걸음실행 에 의 하여 실행 을 한행씩 따라가면서 변수값의 변화 등을 자세 히 주 
적할수 있다. 




v ^ HelloEmplayeeDebug [Java Application] 


» m lAl " 義 뼛 .f. 근 | 


효 


日 


자 ^sample.hello.HelloEmplovee at localhost:32775 

▽ i# Thread [main 】 (Suspended (entry into method main in HelloEmpIcjyee)) 

= HelloEmployee.main(StringLI) line: 18 
► 上 : / Companero~1.2/jdkli 노 Cybin/java (Aug 12, 2005 1:33:41 AM) 

▽ ffi HelloEmplayeeDebug [java Application] 

▽ ^ sample.hello.HelloEmployee at I 。[五 I host: 32777 

▽ i# Thread [main] (Suspended (entry into method ere ate Document in XmlUtilT) 


: X m I Uti I. c reate Doc u mentfFile) line: 45 


: EmpIoyeeMapFactory.IoadEmpIoyee(File) line: 4S 
: EmployeeMapFactory.createEmplofyeeMapO line: 34 
: HelloEmploy&e.main(StringD) Jine: 19 




그림 5-11. [ Debug ] 보기의 단추 


이제 [ Resume ] 단추를 찰칵하여 다음 멈춤점까지 단번에 실행 해 본다. 그러면 for 순 
환의 제일 첫 행에 설정한 행멈춤점에서 중단된다(그림 5-12). 



그림 5-12. 행 멈춤점에서의 중단 
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여 기서 순환계수기의 변수 i 우에 마우스지 적 자를 이동시키면 그림 5-13 과 같이 변 
수 i 의 값이 풍선도움말로 표시된다. 이렇게 마우스지적자를 변수우에 이동시켜 변수의 
내용을 간단히 확인할수 있다. 현재 오의 값이 1로 되여있다. 멈춤점의 속성에서 Hit 
Count 를 2로 설정했기때문에 for 순환의 두번째 실행시에 중단되는것을 확인할수 있다. 


匠 1 Employee.java [ [7] EmployeeMapFactory.java 效 

e.printStackTrace(); 


P 


Node node = doc.getDocumentElement() : 

NodeList nodeList = node.getChildNodes() : 

for (int i = 0; i < nodeList.getLength(); i++) { 

Node childNode = nodeList.item(i); 

if (childNode.getNodeType() == K - NODE) { 

String id = 

XmlUtil. eetAttributeValijpress F2 for focus, "id") ; 

String name = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, "name” )) : 
String role = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, "role" )) : 
String telNumber = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, "telNumber”) ) : 
String bossld = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, "bossld" )); 


HE 


:囚 


그림 5-13. 변수값의 참조 

5.3.2. 걸음바깥 ( step - over ) , 걸음안 ( step - in ) , 걸음되 돌림 ( step - return ) 
여기서는 걸음실행을 해본다. 걸음실행에는 3종류의 단추가 있다. 우선 오유수정보 
기 의 [ step _ t ) ver ] 단추를 찰칵해 본다. [ step ~ over ] 단추를 사용하면 현재 원천코드상에 서 한 
행만 실행하고 다음 행에서 중단된다. [string role =] 행이 반전할 때까지 [ step ^ over ] 단 
추를 여러번 찰칵하여 확인하여본다. 

다음으로 [ steprin ] 단추를 찰칵한다. 

이때 [XmlU 仕 l.Ge 性나 odeValue(XmlU 仕 l.get 分 nlyElemeut (( Element ) 산 “ telNumber ”);) 

의 행이 반전되는것은 [ step - over ] 단추를 리용하였을 때와 차이가 없다. 또 한번 
[ stearin ] 단추를 찰칵하면 이 번에는 XmlUtil 클라스의 원천코드가 편집 기 에 현시 되며 
getOnlyElements 메쏘드의 제일 첫 행에서 중단된다(그림 5_14의 2번째 그림). 

이와 같이 [ sterHn ] 단추를 사용하면 원천코드상에서 다른 메 쏘드를 호출한 경우 그 
메 쏘드의 내 부도 걸 음실 행하는것 으로 된 다. 다시 한번 [ sterHn ] 단추를 찰칵하면 
getOnlyElement 메쏘드의 내부로 뛰 여 넘기 한다. 다시 [ step - in ] 단추를 찰칵해본다. 
ParentNode 클라스의 getElementsByTagName 메쏘드에 뛰여넘기한다. 이 ParentNode 클 
라스는 JRE 의 체계서 고에 포함되 여있는 클라스이 다. 이와 같이 [ sterHn ] 에 의한 걸음실 
행 은 JRE 나 외 부 jar 파일 의 원 천코드가 첨 부되 여있 으면 그들의 내 부까지 걸 음실 행하여 
오유를 수정할수 있 다. 
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函 EmployeeMapFactory.java | 0 XmlUtil.java 1 [J] Employ ee.java 



□ 


510 

* read-only .| 


스 



511 

• f 




: i. 

512^ 

public Node removeChild(Node oldChild) 





513 

throws DOMException { 





514 

// Tail-call, should be optimizable 





515 

return internalRemoveChild(oldChild, false) : 





516 

} // removeChild(Node) : Node 





517 






518 ^ 

519 

520 

521 

522 
523^ 

524 

525 


因 EmployeeMapFactory.java | 函 XmlUtil.java 然 因 Employee.java 函 EmployeeMap.java 


return (null); 
case 1: 

break; 
default : 

throw (new IllegalArgumentExceptionO); 

} 

return (Element)(nList.item(0)); 


public static NodeList getElements(Element element, String name) { 
return element.getElementsByTagName(name); 


函 XmlUtil.java 效 


84 

85 ᄍ 

86 

87 

88^ 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101^7 


public static Element getOnlyElement(Element element f String name) 
NodeList nList = getElements(element, name); 
switch (nList.getLength( )) { 
case 0: 

return (null) ; 
case 1: 


因 EmployeeMapFactory.java 然 0 XmlUtil.java 0 Employ ee.java Qj EmployeeMap.java 

ajiixu lx 丄 . ge Lixuae v d 丄 ue 、—入 jhiu i ■ 丄丄 . ge lvwi 丄 y£ 그는 iH 존 n 노 요 丄 emeu l 丄丄 amucie, 


K 

62 


67 

68 

69 

70 

71 

72 

73 

74 

l 75 

■76 


String role : 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((ElementJchildNode, ” role” )); 
String telNumber = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, "telNumber ")); 
String bossld = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, "bossld 1 ' )) : 
Employee employee = 

new Employee(id, name, role, telNumber); 
employeeMap.put(id, employee); 

Employee boss = (Employee)employeeMap.get(bossld); 
employee.setBoss(boss); 


return employeeMap; 


그림 5-14. [ step - in ] 에 의한 실행 

다음으로 그림 5-14 의 4번째 그림 에 서 [ step - return ] 단추를 찰칵해 본다. 현재 메 
쏘드의 나머지부분이 단번에 실행되여 메쏘드를 호출한 곳에서 중지된다(그림 5-15). 
걸음실행의 중단위치를 나타내는 화살표가 EmployeeMapFactory 클라스의 원천코드에 
돌아올 때 까지 [ step - return ] 단추를 찰칵하여 동작을 확인하여 본다. 
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0 EmployeeMapFactory.java 


然 ' 函 XmlUtiLjava 因 Employee.java j (JJ EmployeeMap.java 

AH1 丄 u L 丄丄 . ge LmKie Vd 止 ut 、 ahi 丄 u l 丄丄 . ge luii 丄 yc •丄 erntfii l 노 v t 丄 tfmeii l 


65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 > 

sd 


. ge Lwuuevd 丄 UK 도 aiii 丄 u l 丄丄 . ge ia;u 丄 yji 丄 emwi l 노 노 l 고 m 丄丄 uiNuue ， 

String role = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, 
String telNumber = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, 

String bossld = 

XmlUtil.getNodeValue( XmlUtil.getOnlyElement((Element)childNode, 
Employee employee = 

new Employee(id, name, role, telNumber); 
employeeMap.put(id ， employee); 


•telNumber..)); 


因 XmlUtil.java 然 


84 

85 우 

86 

87 

88^ 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 
100 
101^7 


* 要棄 s_c 〜 / 一卜 & 指定匕、要素必他全取得 r 冬 . 

public static Element getOnlyElement(Element element, String name) 
NodeList nList = getElements(element, name); 
switch (nList.getLength()) { 
case 0: 

return (null); 
case 1: 


21 EmployeeMapFactoryjava J 2 ) XmlUtil.java 然 [2 Employ ee.java | 2 l Employ eeMap.java 


return (null); 
case 1: 

break; 
default : 

throw (new IllegalArgumentExceptionO); 

} 

return (Element)(nList.item(O)); 


* 指定 y — ko 指定/ » 性여 ) 1 j ᄌ卜 s ： 取得 r * 

public static NodeList getElements(Element element, String name) { 

return element.getElementsByTagName(name); 

> 

El Employ eeMapFactory java 臣 ] XmlUtil.java 因 Employee.java 


510 

511 
512^ 

513 

514 

515 

516 

517 
518^ 

519 

520 

521 

522 
523^ 

524 

525 


* read-only.| 

public Node removeChild(Node oldChild) 
throws DOMException { 

II Tail-call, should be optimizable 
return internalRemoveChild(oldChild, false) ; 

} // removeChild(Node) : Node 

/** NON-DOM INTERNAL: Within DOM actions,we sometimes need to be able 

* to control which mutation events are spawned. This version of the 

* removeChild operation allows us to do so. It is not intended 

* for use by application programs. 

*/ 

Node internalRemoveChild(Node oldChild, boolean replace) 
throws DOMException { 


그 U 


그림 5-15. [ step - return ] 에 의한 실행 


EmployeeMapFactory 클라스로 돌아가서 [ Resume ] 단추를 찰칵하여 다음의 멈 
춤점까지 단번에 실행해본다. 다음으로 중단하는것은 감시점으로 설정한 Employee 클라 
스의 name 마당에 대 입하는 부분이 다.(그림 5-16) 
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그림 5-16. 감시점을 설정한 변수의 변경에 의한 중단 

5.3.3. [ Variables ] 보기 

여기서 [ Debug ] 투시의 웃부분오른쪽에 있는 [ Variables ] 보기를 본다(그림 5-17). 
다른 보기가 현시되여있는 경우에는 [ Variables ] 태브를 찰칵하여 [ Variables ] 보기를 현 
시한다. [ Variables ] 보기에는 멈춤점에서 참조할수 있는 변수목록이 있다. 지금은 
Employee 자체의 구체례의 참조인 比 iis 와 메쏘드의 인수에 넘겨지는 국부변수들인 id , 
name , role , telNumber 가 표시 되 였 다. ▽단추를 찰칵하여 전개하면 그 구체 례 에 설정 
되 여 있는 마당값을 조사할수 있 다. this * 전개하면 그림 5-17 과 같이 성 원마당의 name 
에 는 어떤 값도 설정 되 여있지 않다는것 을 알수 있다. 
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t ^ B - 




Breakpoints 


▽ 效 this: Employee fid=21) 
e boss= null 
t> b id= "or 1 

囚 name: null 
□ role= null 
b telNumber- null 

I > O id- "or 

|> 必 name= “리 철 호” 


if 


그림 5-17. [Variables ( 변수)]보기에서 객체의 마당을 현시 

[ step - over ] 단추를 찰칵해 본다. [ Variables ] 보기 를 보면 Employee 의 name 마당 
에 《리철호》라고 설정되여있는것을 볼수 있다(그림 5-18). 


Variables r £Z Breakpoints 

l 대 B ，■，ᄆ 

白 

▽ 效 this= Employee (id=62) 



e bos s= nuJ] 



I> e id= M or 



I> 0 name= “ 리 철 호 ’’ 


히 

b rale- null 



B telNumber= null 



I> O id= "or 



l> - - name= 

¥■ 


A. 

V 

[UZ 

in 



그림 5-18. name 마당에 값을 설정 

[ Variables ] 보기 에서 는 변수의 값을 변경 할수도 있다. [ Variables ] 보기 에서 this 의 
name 마당을 두번 찰칵한다. 그림 5-19 에서 보여준 대화칸이 현시되는데 《리금성》으로 
변경 시키 고 [ OK ] 단추를 찰칵한다. 
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Value 



Enter b new value for name: 


_ 

A 

HI 卜 



OK Cancel 


그림 5-19. 값설정대화칸 

[ Variables ] 보기에서 값이 변경된 곳을 확인할수 있다(그림 5-20). 


效 > Breakpoints 

fci 배 B ，， D 

□ 

▽ G this: Employee fid-62) 


美 

因 boss= mil 



I > b id="Gr 






m rde~ mil 

s telNumber= null 



t > 必 id : "or 



I > 必 name: “ 리철호 ” 


_ 

리 철호 


爲 

單 


IH 



그림 5-20. name 마당의 값 변경 

다시 [ Resume ] 단추를 찰칵한다. Employee 클라스의 다음 구체 례 가 생 성 되 여 
name 마당에 값이 설정되기때문에 감시점의 멈춤점에 의해 실행이 중단되는것을 확인할 
수 있다(그림 5-21). 또 한번 [ Resume ] 단추를 찰칵한다. 세번째 구체 례 가 생성될 때 
다시 중단되 기 때 문에 다시 [ Resume ] 단추를 찰칵한다. 
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그림 5-21. 다른 구제례의 감시점에서의 중단 

다음번에 중단하는것은 그림 5_22와 같이 Employee.Java 의 display 메쏘드이다. 
여 기서 감시점 이 설정되 여 있는 name 마당을 참조하고있기때문에 [ outline ] 보기 에서 
name 마당을 찰칵하여 name 의 선언부를 표시하고 감시 점 표식을 오른쪽찰칵하여 
[ DisableBreakpoint ] 를 선택한다. 이렇게 실행이 중단된 상태에서도 멈춤점의 《설정/ 
제거》나〈〈사용가능/사용불가능》의 변경 을 진행할수 있다. 

[ Resume ] 단추를 찰칵하면 감시점을 무효로 하기때문에 다른 Employee 클라스의 
구체 례의 display 메쏘드에서 중단하는것이 아니라 제일 마지막까지 실행 되여 
[ console ] 보기에 문자렬이 출력된다. [ console ] 보기에 출력된 문자렬이 XML 파일에서 
읽어 들인 값으로부터 변수마당에서 변경된 값으로 되 였는가를 확인한다(그림 5-23). 
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그림 5-22. 감시점을 설정한 변수의 참조에 의한 중단 



5.3.4. [ Breakpoints ] 보기 

[ Debug ] 투시의 오른쪽우에 있는 [ Breakpoints ] 래브를 찰칵하여 [ Breakpoints ] 
보기를 현시한다(그림 5-24). [ Breakpoints ] 보기에는 《사용가능/사용불가능》에 관계 
없이 현재 설정되여있는 멈춤점의 목록이 현시된다. 
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[ Breakpoints ] 보기 의 검 사칸들을 선택 하여 멈 춤점 의《 사용가능/사용불가능》을 간 
단히 절환할수 있 다. [Skip all Breakpoints ] 단추를 리 용하면 현재 의 설정 을 유지 한 상 
태로 일시적으로 모든 멈춤점을 사용불가능하게 할수 있다. 또한 멈춤점을 오른쪽찰칵하 
여 표시되는 지름차림표에서 멈춤점의 제거나 속성의 변경도 할수 있다. 여기서 
EmployeeMapFactory ( File ) 메 쏘드에 설정되 여있는 멈춤점외의 다른 멈춤점들을 사용 
불가능으로 한다. 이와 같이 [ Breakpoints ] 보기를 사용하면 멈춤점의 속성을 쉽게 변 
경할수 있다. 


Variables 


寒，. Sreakpoint 5 X 


* 效驗，현 爲 \ 


Jo 


日 


후 EmployeeMapFactory [line: 55J [hit count: 2] - loadEmplcsyee(Rle) 


0 ，第 * Xml Util [entry] - createDocument(FiI e) 

□ ^Employee [access and modification] - name 


그림 5-24. [ Breakpoints ] 보기 


5.3.5. 걸음려과기 (Step filter) 의 사용 

[5.3.2. 걸음바깥，걸음안，걸음되돌림]의 걸음실행 에서 는 [ Step - in ] 단추를 사용하 
면 JRE 의 체 계서고에 포함되 여있는 클라스의 메 쏘드내부에서도 걸음실행할수 있다. 그 
러나 보통 JRE 나 외부 jar 의 클라스까지 걸음실행을 하지 않는 경우가 많다. 그런 경우 
자체 로 작성한 클라스의 메 쏘드내 에서 만 [ step - in ] 동작을 하고 그 밖의 클라스에서 는 
[ step - over ] 에 의 하여 동작하는것 이 편 리 하다. 그것 을 가능하게 하는것 이 [ Debug ] 보 
기 의 [Step filter/Use Step Filter ] 단추이 다. 

이 기능을 사용하기 위해서는 걸음실행을 하지 않는 클라스를 설정해 놓아야 한다. 
차림표띠에서 [ Window ] ᅳ [ Preference ] 을 선택하여 대화칸을 열고 대화칸의 왼쪽에서 
[ Java ] 구 [ Debug ] —[ Step Filtering ] 를 선택 한다(그림 5- 25). 
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그림 5-25. 걸읍려과기설정 대화칸 


기정으로는 여 러 개의 려과기 가 등록되 여 있고 java . lang.ClassLoader 려과기 만이 
유효하게 되 여있 다. 이 대 화칸에 서 려 과기 를 등록하여 유효하게 해 놓으면 [ Debug ] 보기 
의 [Step filter/Use Step Filter ] 단추가 유효하게 되 며 려 과기 에 맞는 클라스의 메 쏘드 
내에서 걸음실행을 하지 않게 된다. 

5. 3. 2의 [ Step - in ] 실 행 에 서 는 org . apache , crimson , tree . ParentNode 클라스까지 
들어 가기 때 문에 이 클라스에 서 걸 음실 행하지 않게 려 과기 를 등록한다. 그림 5-25 의 대 
화칸에 서 [Add Packages ...] 단추를 찰칵하면 그림 5_26의 대 화칸이 열 린 다. 우의 본 
문입 력 구역 에 《 org . apach 》 라고 입 력 하면 아래 구역 에 org . apache 패 키 지 가 현시 되 는데 
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이것을 선택 하여 [ OK ] 단주를 잘칵한다. 걸음려과기의 설정대화칸에 돌아가보면 
org . apache .* 가 목록으로 표시되는것을 확인할수 있으며 [Enable All ] 단추를 찰칵한 
다. 등록된 파일 전체 가 유효하게 된것을 확인하고 [ OK ] 단주를 찰칵하여 대화칸을 연다. 

차림표띠에서 [ Run ] —[debug history ] —[ HelloEmployeeDebug ] 를 선택하여 오 
유수정 프로그람을 기동한다. 멈춤점 에서 실행 이 중단되면 5.3. 2에서 [ Step - in ] 실행 을 
개시한 장소까지 코드를 실행시킨다. 전번에는 [ Step - over ] 단추를 사용하였지만 이번 
에 는 편집 기 에서 [String role =] 의 행 에 지 적자를 이동시키 고 오른쪽찰칵하여 [Run to 
Line (지정한 행까지 실행)]을 선택한다. 그러면 지적자행의 앞까지의 코드가 단번에 실 
행되여 그 행에서 실행이 중단된다. 이 기능을 사용하면 걸음실행할 필요가 없는 도중의 
코드를 단번에 실행시킬수 있으므로 기억해 둘 필요가 있다. 

이렇게 5.3. 2에서 [ Step - in ] 실행을 한 위치에 도달한다. 여기서 [ Step - filter/Use 
Step Filter ] 단추를 찰칵하여 이 기 능을 유효 (단추가 눌린 상태 )상태 로 한다. 이 상태 에 
서 [ Debug ] 보기의 [ Step - in ] 단추를 사용하여 걸음실행을 진행하기로 한다. 



그림 5-26. 걸음려과기의 추가 


124 


錢變邊 錢變變繼繼繼 
















세 5 장. 모유4경 


5.3. 2의 [Step-in] 실행에서는 ParentNode 클라스내부까지 걸음실행하였지만 이번에 
는 ParentNode 클라스의 메쏘드내에 들어가지 않고 호출한 쪽으로 돌아가는것을 확인하 
여본다. 확인한 다음 [Debug] 보기의 [Finish] 단추로 오유수정프로그람의 실행을 끝마치 
고 려과기설정을 기정으로 되돌려 놓는다. 그리고 차림표띠에서 [Window] ᅳ 
[Preference] 을 선택 하여 대화칸을 열고 대화칸의 왼쪽에서 [Java] ᅳ [Debug] ᅳ 
[Step-filter] 를 선택 한다. 걸음려과기설정에서 오른쪽아래에 있는 [Restore Default] 단 
추를 찰칵하면 설정 이 원래 대 로 돌아가며 [OK] 단추를 찰칵하여 대 화칸을 닫는다. 


[걸음려과기/걸음오유수정의 사용：!의 보층 

엄밀하게 [걸음려과기/걸음오유수정의 사용]이 유효로 될 때의 걸음실행은 려과기 
가 유효하게 된 클라스의 메쏘드만이 되는것은 아니다. 다음의 실례를 보기로 하자. 

Public class A{ 

B b=new B(); 

Public void methodAO { 
b. methodBO ； 


// 클라스 B 만이 려과기에 등록된것으로 한다. 

Public class B{ 

C c=new CO; 

Public void methodBO { 
c. methodCO; 


Public class C{ 

Public void methodCO { 

System, out. println( “이 곳은 걸 음안이 다. ” ) ； 


여기서 클라스 B 가 려과기의 대상으로 되는것으로 한다. [걸음려과기/걸음오유수정 
의 사용]을 유효로 하고 클라스 A 의 methodA 메 쏘드를 [step-in] 에서 실행시키 면 
b. methodBO 를 실행 하고 다른 클라스의 메 쏘드를 걸음실행하지 않으며 methodA 
메쏘드가 완료되는것이 아니라 클라스 C 의 methodC 메쏘드의 제일 첫행에서 중단된 
다. 결국 려과기가 유효한 클라스로부터 려과대상밖의 클라스의 메쏘드를 호출하는 
경 우에 도 려 과대 상밖의 클라스의 메 쏘드내 부에 는 [step-in] 실 행한다. 따라서 JRE 
나 외부 jar 파일의 클라스의 메쏘드에서 걸음실행을 하지 않도륵 하려면 그것들에 포 
함되 는 전체클라스가 대 상으로 되 도록 려 과기 를 설정해 둘 필요가 있 다. 
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5.3.6. [Display] 보기， [Expression] 보기 

[Variables (변수)]보기를 사용하면 변수의 값을 조사할수 있지만 오유수정과정에 
메 쏘드의 되돌이값을 알아야 할 경우도 있다. Eclipse 에서는 오유수정프로그람을 사용하 
여 멈춤점에서 중단하였을 때에 임의의 식을 평가할수 있다. 

그 방법을 설명하기 전에 몇가지 준비가 필요하다. [Java] 투시로 절환하여 
[Package Explorer] 보기 에서 [SampleChap5] 프로젝 트— [src] 서 류철 -수 [sample, hello] 
패 키 지 — [EmployeeMap. java] 를 두번 찰칵하여 원천코드를 현시 한다. [Window] 보기 
에서 display 메쏘드를 선택하고 display 메쏘드내의 《 eArray[i]. display 0 ;》에 행멈 
춤점을 설정한다. 다시 오유수정투시로 절환하여 [Breakpoints] 보기 ([5.3.4. 
[Breakpoints] 보기]를 참조)에서 이 자 설정한 멈 춤점 외 의 다른 멈 춤점 들을 사용불가능 
으로 한다. 이것으로서 준비가 완료된다. 

차림 표띠 에 서 [Window] —[Display view] —[Display] 를 선택 하여 [Display] 보 
기를 현시 한다(그림 5-27). [Display] 보기는 [Debug] 투시의 아래 단에 현시된다. 차림 
표띠 에 서 [Run] —[Debug History] —[HelloEmployeeDebug] 를 선택 하여 오유수정 
프로그람을 실행시킨다. Employ eeMap 클라스의 display 메쏘드의 멈춤점에서 
[Display] 보기 에 다음의 식 을 입 력한다. 

eArray [ i ]. getName 0 



그림 5-27. [Display] 보기 

입 력된 식 을 선택 하고 마우스오른쪽단추를 찰칵하여 [Display] 를 선택하면 식의 평 
가결과가 [Display] 보기에 현시된다(그림 5-28). 



그림 5-28. 식의 평가결과를 [Display] 보기에서 현시 


다음으로 [Debug] 보기에서 HelloEmployee. main (String []) 의 탄창프레임을 선 
택하고 같은 방법 으로 [Display] 보기 를 사용하여 앞의 식 의 평 가결 과를 현시하여본다. 


126 


錢變邊 錢變變繼繼繼 



















세 5 상. 모유4청 


이렇게 하면 그림 5_29 와 같이 식 평가가 실패 한다. 이것은 HelloEmployee. main (String []) 
의 문맥 에서는 earray 나 호라는 변수가 유효범위밖에 있기때 문이 다. 이와 같이 
[Display] 보기 에서의 식평 가는 [Debug] 보기 에서 선택되 여있는 탄창프레 임 에 의존한다. 



그림 5-29. 유효범위밖에서 식을 평가한 경우 



그림 5-30. [ Display ] 보기에서 [ inspection ] 를 실행 


Variables Breakpoints | 


Exp res a ion 


' 、己 A rray [i] .get N am e0' ，= 


a F c ount- 10 
0 hash= 0 

國 F offset^ 0 

t> ■ F vaiue= char[10] (jd ： =2€i) 



三 


HT 




그림 5-31. [ Expressions ] 보기에서 식평가결과를 현시 


[Debug] 보기에서 EmployeeMap.display 0를 선택하고 원래의 탄창프레임으로 
돌아간다. [Display] 보기에서 앞에서 입력한 식을 선택하고 마우스오른쪽단추를 찰칵하 
여 [inspection] 를 선택 한다. [Display] 를 선택 하였을 때 에는 되돌이 값형과 값만이 현 
시되지 만 이번에는 그림 5-30 과 같이 보다 자세한 내용이 튀여 나오기창에 현시된다. 여 
기서 ctrl+shift+1 을 누르면 그림 5_31 의 [Expressions] 보기가 [Debug] 투시의 오른쪽 
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우에 현시 된다. [Expressions] 보기 에 는 앞서 본 튀 여 나오기 창의 내 용이 현시 되 여 있 다. 

[Debug] 보기 의 [Resume] 단추를 찰칵하면 두번째 Employee 클라스의 구체 례 의 
정 보를 조종탁에 출력 하기 직전에 중단된다. 이때 eArray [i] .getNameO 의 평 가결과는 
[김돌석] 이 아니지 만 [Expressions] 보기 에서는 변화되지 않는다. 이와 같이 
[inspection] 의 경 우 식 평 가는 한번뿐이 다. 식 을 계 속하여 평 가하려 면 [Expressions] 
보기 에서 [eArray[i] .getNameO] 을 선택 하여 마우스오른쪽단추를 찰칵하고 
[Reevaluate Watch Expression] 을 선택 한다. 그림 5_32 와 같이 현시 가 바뀌 여 방금 
중단된 위치에서의 평가식이 현시된다. [Debug] 보기에서 [Resume] 단추를 찰칵하여 다 
음 멈춤점에서 중단되였을 때에는 식을 평가하여 고쳐진것을 확인한다. 



그림 5-32. [Reevaluate Watch Expression ] 실행후 결과 


제4절. 오유수정의 실례 

여기서는 Junit 시험이 실패한 례를 리용하여 실제로 오유수정를 진행해본다. 앞절 
들에서 설정한 멈 춤점 은 [Breakpoints] 보기 등을 사용하여 모두 제 거한다. [Java] 투시 
의 [Package Explorer] 보기 에서 SampleChap5 프로젝트를 연다. [test] 서 류철 — [samp 
le. hello] 패키지 — [EmployeeMapFactoryTest. java] 의 원천코드를 현시하고 testGre 
atEmployeeMap 메쏘드의 첫 행을 목록 5_1 과 같이 employee.xml 로부터 employee2. 
xml 로 변경시킨다. 

목록 5-1. EmployeeMapFactoryTest#testCreateEmployeeMap() ( 일부 ) 

public void testCreatEmployeeMap 0 throws Exception { 

{EmployeeMapFactory eFactory=new EmployeeMapFactory( “employee2.xml” )； 
EmployeeMap eMap =eFactory. createEmployeeMapO ； 
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목록 5-2. Employee2.xml 

<?xml version^ ‘1.0’ encodings “shift_JIS” ?> 
<EmployeeList> 

〈Employee id = “02” > 

<name> 김 영 수 </name 〉 

<role>designer</role 〉 
<telNumber>111122223</ telNumber> 
<bossld>01</bossld> 

〈 /Employee 〉 

〈Employee id = “03” > 

<name> 김 돌석 </name 〉 
<role>Engineer</role 〉 
<telNumber>666</ telNumber> 
<bossld>01</bossld> 

〈 /Employee 〉 

〈Employee id = “01 ” 〉 

<name> 리 철 호 </name 〉 

<role>manager</role 〉 
<telNumber>999888777</ telNumber> 
<bossId> 

〈 /Employee 〉 

</EmployeeList> 


변경시 킨 시험 경우를 실행시켜 보기 로 한다. [Package Explorer] 보기 에서 
EmployeeMapFactoryTest. java 를 선택 한 상태 에서 차림 표띠 에서 [Run] —[Run 
As] ᅳ [Junit test] 을 선택한다. 시험은 실패하고 [Junit] 보기에 실패한 시험의 정보가 
현시된다(그림 5-33). 오유추적에서 제일 꼭대기의 탄창프레임을 두번 찰칵하면 편집기 
에 실패한 assertEquals 문이 현시된다. [Junit] 보기의 통보문에서 알수 있는바와 같이 
e02.toStringO 의 결과가 예측한 문자렬과 다른것이다. 
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그림 5-33. 실패한 검사 

좀더 자세 히 보기 로 한다. 앞에 서 실패한 assertEquals 문에 행 멈 춤점 을 설정한다. 

멈 춤점 을 설정한 다음 차림 표띠 에서 [Run] ᅳ [Debug History] ᅳ 
[EmployeeMapFactoryTest] 를 선택하여 오유수정 프로그람을 기동한다. 멈 춤점 에서 
실행이 중단되므로 e02.toStringO 의 값을 알수 있다. Java 편집기에서 e02.toStringO 
을 마우스로 끌기하여 반전시 킨다 (그림 5-34). 
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그림 5-34. e02.toString () 의 되돌림값을 조사 


II ； Employee.java 
기 34 


미 


效 


35 

|36 

J37 

38 

39 

40 

41 

42 

43 

44 

45 

46 


eOl. toStringO 

)； 

" I 

Employee e02 = eMap.getEmployee( 
assertEquals (:丄쁘 

); 


(java.lang.String) [02, 


.Designer,111122223 


■ 豆 [ 초 ] 

.null]0 


Employee e03 = eMap.getEmployee("03"); 
assertEquals(" [03, ,Engineer,666,[01 , 

e03. toStringO 

)； 


: ， Manager, 999888777, null] ]" 


그림 5-35. e02.toString () 의 평가결과 


assertEquals 문에 서 문자렬 을 비 교하면 《 01，리 철 호，공개 원천프로그람 
**， Manager. 999888777, null》 부분이 null 로 된다(그림 5-35). [Variables] 보기를 현 
시하여 e02 마당을 조사하면 boss 마당이 null 로 되는것이 문제이다(그림 5-36). 


’.’1 安 ’' Breakpoints 

Expressions 

래 B ▼ 

1> & this= EmployeeMapFactoryTest (]d=17) 
t> O eFacttsry= Employee Map Factory (id=42) 
t> ◊ eMap= EmpItjyeeMap (id =43) 

I> 後 e01= Employee (\d=44) 

▽ 니 e02= Employee Cid=33) 

0 bos5= null 

t> a if 02" 

I> 囚 name= 

스 

: 

<1 ，公 IH 


그림 5-36. e02 마당의 값 
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e02 의 boss 마당이 id= “01” 인 Employee 객체를 참조하고있다면 toStringO 의 결 
과가 예상한대로 되는가를 확인한다. [Variables] 보기를 보면 e()l 에 e02 의 boss 마당에 
설정할수 있는 객체가 설정되여있다. [Display] 보기를 사용하여 e02.setBoss(eOl) 의 
코드토막을 실행하여 (그림 5-37) 다시 한번 java 편집기에서 e02.toStringO 을 선택ᅳ 
오른쪽찰칵— [Display] 에서 결과를 확인한다(그림 5-38). 이렇게 하면 assertEqual 문 
에서 비교하려는 문자렬과 같은 문자렬로 되므로 Boss 마당이 정확히 설정되지 않았다는 
가정이 옳게 된다. 


Console Tasks ■법 

、 예 ]! ° 

3 

e02. setBoEsf e01)H : ‘ ' 一 ’ ' ᅳ ’" 


美 



용 : 



V 

田 [ 

:因 

_ 


그림 5-37. e02.setBoss(e01 ) 을 실행 


函 Employee.java 因 


然 


eOl. toStringO 
)； 

//‘ g 수 , 

Employee e02 = eMap.getEmployee( I 

assertEquals (: 上 £ 느 


(java.lang.String) [02, 


Manager,999888777,null]] 


.Designer,111122223,[01, 


// - 

Employee e03 = eMap.getEmployee("03"); 
assertEqualsC" [03, .Engineer,666,[01, 

e03. toStringO 
)； 


.Manager,999888777,null]]" , 


46 


그림 5-38. setBoss 실행후의 e02.toString () 의 평가결과 

여기서 boss 마당이 변경되였을 때의 변수값을 조사해보기로 한다. [Debug] 보기의 
[Finish] 단추를 찰칵하여 일 단 실행 을 중지시 킨다. [Java] 투시 로 절환하여 
Employee, java 의 원천코드를 현시 하고 boss 마당에 감시점 을 설정 한다. 실행시 에 
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boss 마당에 설정되여있는 객체를 확인하려면 멈춤점의 속성에서 [field access] 의 선택 
을 제 거하여 놓는다. 

[Debug] 투시로 절환하여 차림표띠로부터 [Run] ᅳ [Debug History] ᅳ 
[EmployeeMapFactoryTest] 를 선택하여 다시 한번 오유수정프로그람을 기 동한다. 이 
렇게하면 Employee 클라스의 setBoss 메쏘드에서 실행이 중단된다. 

[Debug] 보기에서 현재 탄창프레임의 바로밑에 있는 

EmployeeMapFactory. lc 必 dEmployee(file) 의 탄창프레 임 을 선택 한다. [Variables] 
보기 에서 변수 employee 를 보면 id=“02” 의 Employee 클라스의 구체 례를 참조하고있 다. 
setBoss (boss) 메 쏘드의 인수에 넘겨진 국부변수 boss 를 [Variables] 보기에서 조사하면 
null 로 되여있다(그림 5-39). 


SMKh Qntvri 

，， 戶， ， * ， 


tn do —， - 



그림 5-39. 탄창프레임의 선택 

국부변수 boss 에는 화살표로 지적된 코드의 한 행앞에서 
employeeMap.get(bossId) 의 결과가 설정되여있다. [Variables] 보기를 보면 bossld 
는 이로 되여있으므로 id= “01” 인 Employee 객체를 얻게 된다. 그래서 [Variables] 보 
기로 EmployeeMap 의 상태를 조사한다. [Variables] 보기에서 [employeeMap] 의 왼 
쪽에 있는 [> 단추를 찰칵하여 employeeMap 의 내 용을 현시한다. 여 기서 [Show 
Logical Structure] 아이 콘을 찰칵하여 현시 를 절환시 켜 본다(그림 5-40) . [론리 구조] 
가 유효로 되 면(눌러여 진 상태 ) HashMap 나 ArrayList 등의 집 합클라스가 가지 고있는 
객체만이 현시된다. 분명 employeeMap 에는 id= “02” 인 Employee 객체밖에 설정되지 
않고 id= “01” 의 Employee 객체는 존재 하지 않는다. 
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틀 被 


Breakpoints 


Expressions 


대 



1> 效 this= EmployeeMapFactory Cid=18) 

I> 公 xmlFile: File 0d=35> 

▽ employee Map = HashMEip<K f V> (id=3 9) 
a entrySet= null 

▲ keySet= null 

▲ F loadFacror= 0.75 

▲ modCount= 1 

▲ 5ize= 1 


V 


:因 


그림 5-40. employeemap 의 상태 

왜 id = “ 01” 의 Employee 객 체 가 존재 하지 않게 되 는가? Employee 객 체 는 
employee 2. xml 파일을 기 초로 생성되지만 생성되는 순서는 employee 2. xml 파일에서 
서술된 순서로 된다. 따라서 id = “01” 의 Employee 의 객체는 id = “02” 의 객체보다도 
후에 생성되기때문에 이 시점에서는 id = “01” 의 객체를 참조할수가 없다. 결국 상급 
( boss ) 에 해당한 Employee 객체가 먼저 생성된 경우에는 문제가 없겠지만 상급의 
Employee 객체가 하급의 객체보다도 후에 생성되는 경우에 하급으로부터 상급에로의 관 
련설정이 정확히 설정되지 않는 오유가 이 프로그람에 존재한다. 

이 것 을 해 결 하는 방법 에 는 여 러 가지 가 있으나 여 기 에 서 는 모든 Employee 객 체 가 생 
성 된 다음에 상급과 하급의 관련을 설정하는 방법 에 대 하여 취 급한다. 판본 1.4 이 후의 
Java 가상기 계 를 사용하는 경 우는 멈 춤점 에 서 중단된 상태 에 서 코드를 수정하여 계 속 실 
행 시 킬수 있 다. EmployeeMapFactory 클라스의 loadEmployee 메 쏘드를 목록 5_3과 
같이 수정한다. 


목록 5-3. EmployeeMapFactory#loadEmployee(file) 

* 파일 에 서 직 원정 보를 읽 기한다. 

*9 param employeeMap 
*9 param xmlFile 
*/ 

private java . util , map loadEmployee (file xmlfile ) { 
java . util , map employeemap = new hashMapO ； 
//(5.4) id 와 bossld 의 대 조를 일 시 보관하기 위한 HashMap 
java . util , map bossmap=new HashMapO ； 

XmlUtil xUtil = null ； 
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Document doc = null ; 

Try { 

xUtil =new XmlUtilO ； 

doc = xUtil . createDocument ( xmlfile ) : 

} catch (Exception e ) { 
e . printStackTrace 0 ; 

} 

Node node = doc . getDocumentElementO ； 

NodeList nodeList = node . getChildNodes () : 
for (int i =0; i < nodeList . getLength () : i ++) { 

Node childNode = nodeList . item ( i ) ； 

if ( chidNode . getNodeTypeO == Node . ELEMENT _ NODE ) { 

String id = XmlUtil . getAttributeValue ( childNode , “ id ” ); 

String name = XmlUtil.getAttributeValue 

( XmlUtil . getOnlyElement (( Element ) childNode , “ name ” )); 
String ro 1 e = getNodeValue(Xm 1 Uti 1 . getOnlyElement ( 

( Element ) childNode , “ role ” )); 

String telNumber = getNodeValue(XmlUtil . getOnlyElement ( 
( Element ) childNode , “ telNumber ” )); 

String bossId = getNodeValue(XmlUtil . getOnlyElement ( 
( Element ) childNode , “ bossld ” )); 

Employee employee=new Employee ( id , name , role , telNumber ) ； 
employeeMap . put ( id , employee ) : 

//(5.4) 다음의 2 개 행에 설명문을 붙인다. 

//Employee boss = ( Employee ) employeeMap . get ( bossld ) : 

// employee . setBoss ( boss ) ； 

"(5.4) bossld 를 림시 보관한다. 
bossMap . put ( id , bossld ) : 


for ( java . util . Iterator itr = bossMap . keySet 0. iterator () ； itr . hasNextO ；) { 
String id = ( String ) itr . next 0; 

String bossId = ( String ) bossMap . get ( id ) ； 

(( Employee ) employee , get ( id )). setboss ( 

( Employee ) employeeMap . get ( bossld )) ； 

} 

return employeeMap ； 
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수정한 다음 편집한 원천코드를 보존한다. 이때 코드가 콤파일되여 현재 실행중인 
메쏘드의 제일 첫 행으로 중단위 치를 나타내는 화살표가 이동하게 된다(그림 5-41). 결 
국 수정된 메쏘드의 제일 처음부터 실행이 재개된다. 

private java .util. Map loadEitiployee(File xmlFile) { 

[java .util. Map employeeMap = new HashMap(); 
java.util.Map bossMap=new HashMap() : /// 

XinlUtil xUtil : null : 

Document doc - null ; 
try { 

xUtil = new XmlUtlK); 
doc = xUtil.createDocument(xmlPile); 

} catch (Exception e) { 
e.printStackTracef); 

} 

Node node = doc. getDocujnentEleinGnt(); 

NodeList nodeList - node.setChildNodesf) : 

그림 5-41. 쿄드수정후의 중단위치 



Hot 코드치환 

판본 1.4 이후의 Java 가상기계를 사용하는 경우는 멈춤점에서 중단된 상태에서 코 
드를 수정하고 계속하여 수정후의 코드를 실행시킬수 있다. 이것을 Hot 코드치환이 
라고 한다. 그러나 Hot 코드치환에 대응하지 않는 가상기계를 사용하는 경우나 다 
음과 같이 클라스의 구조를 변경시키는 수정을 하는 경우에는 hot 코드치환에서 실 
패 한다. 

• 메쏘드의 추가나 삭제 

• 파일의 추가나 삭제 

• 내 부클라스의 변경 (외부클라스의 private 마당에 대 응하는 접근의 추가나 삭제) 

이 경 우 실 행 상태 에 수정 된것 이 반영 되 지 않으므로 수정후의 코드를 실 행 하기 
위 하여 서 는 오유수정프로그람을 기 동하여 고칠 필요가 있 다. Eclipse 3.0 부터 는 hot 
코드치환에서 실패하였을 때 현시되는 통보문대화칸에 오유수정프로그람을 재기 동시 
키 는 단추가 추가되 여있 다. 
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[ Debug ] 보기 에 서 [ Resume ] 단추를 찰칵하여 멈 춤점 에 서 중지 되 면 다시 한번 
[ Resume ] 단추를 찰칵하여 [ Variables ] 보기 에서 boss 마당에 설정된 값을 관찰한다. 
id =“03” 인 Employee 객체의 boss 마당에 id =“01” 인 Employee 객체가 설정되도록 하 
였다(그림 5-42). 걸음실행 단추나 [ Resume ] 단추를 사용하여 처 리를 전진시 키 고 boss 
마당에 Employee 객체가 설정되는것을 확인하면서 EmployeeMapFactoryTest 를 마지 
막까지 실행시켜 본다. 시험의 실행 이 끝나면 [ Debug ] 투시의 제 일아래 에 있는 [ JUnit ] 
태브를 찰칵하여 [ Junit ] 보기를 현시시켜 본다. 푸른 띠가 현시되면 시험이 통과된것으 
로 된다. 



그림 5-42. 쿄드수정후의 실행 
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제6장. JDT 의 고급한 사용법 

제 3 장부터 5 장까지에서 프로그람작성，콤파일，실행，시험，오유수정과 일반적인 
조작들에 대하여 설명하였다. Eclipse 를 리용한 Java 응용프로그람의 개발방법에 대하여 
기본적으로 리해하였다고 보면서 이장에서는 실제로 개발작업에 쓸모있는 JDTCJava 개 
발도구)의 기 능에 대 하여 몇 가지 소개한다. 

제 1 절 . [Java Browsing] 투시 

차 림 표띠 에 서 [Window] — [Open perspective] — [Java Browsing] 를 선택 하면 
[Java Browsing] 투시가 열린다(그림 6-1) . 또한 투시절환도구의 [Open perspective] 
— [Java Browsing] 에서도 [Java Browsing] 투시를 열수 있다. 



그림 6-1. [Java Browsing ] 투시 

웃부분에 4 개의 보기가 나란이 놓여있는데 왼쪽으로부터 [Projects] 보기， 

[Packages] 보기 ， [Types] 보기 ， [Members] 보기 가 있 다. 
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[ Project ] 보기 는 프로젝 트를 현시 하기 위한것 인데 프로젝 트를 두번찰칵하여 전개 하 
면 그 프로젝트에 설정되여있는 건립경로(서류철 또는 jar 파일)가 현시된다. [ Project ] 
보기 에서 원천서 류철 이 나 jar 파일을 선택하면 그 서 류철 또는 jar 파일 에 포함되 여있는 
패 키 지 목록 이 [ Packages ] 보기 에 현시 된 다. [ Packages ] 보기 에 서 패 키 지 를 선택 하면 그 
패키지에 포함된 형 (클라스 또는 대면)목록이 [ Types ] 보기에 현시된다. [ Types ] 보기 
에서 형을 선택하면 형의 성원(변수 또는 메쏘드)이 [ Members ] 보기에 현시된다. 

원천코드가 편집기령역에 현시되지 않을 때에는 [ Types ] 보기에서 형을 두번찰칵하 
면 선택된 형의 원천코드가 편집기령역에 표시된다. [ Members ] 보기에서 성원을 두번찰 
칵하면 편집기령역에 원천코드가 열리며 선택된 성원의 선언부가 현시된다. jar 파일에 포함 
되 여있는 클라스 등에 원천코드가 첨부되 여있지 않는 경 우는 해 당한 코드가 없다는 통보문 
을 내보내고 그 클라스성원의 서명 ( signature ) 일람이 편집기령역에 현시된다(그림 6-2). 



그림 6-2. 원천쿄드가 첨부되여있지 않는 경우 

실제 로 org . w 3 c . dom.Document 대 면의 성 원을 현시 하기 로 해 보자. 

1. Eclipse 를 기동하고 SampleChap 6 프로젝트를 연다. 

2. 차림 표띠 에 서 [ Window ] — [Open Perspective ] — [Java Browsing ] 를 선택 하여 
[Java Browsing ] 투시를 연다. 
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그림 6-3. 아 g.w3c.dom.Docunent 의 원천쿄드를 현시 

[Java Browsing ] 투시는 기능적으로는 [ Java ] 투시와 크게 차이가 없지만 참조에서 
대 상을 좁혀 서 배 치하였 다. [ Java ] 투시 의 [Package Explorer ] 보기 와 [Java 
Browsing ] 투시 의 4개 의 보기 가운데 서 어 느것 을 사용하는가 하는것 은 개 발자들의 선택 
하는데 달려있지 만 보기 들이 분할되 여있는 [Java Browsing ] 투시 가 참조나 조작하는데 
서 더 좋을것이다. 또한 [ Java ] 투시보다 편집기령역을 넓게 사용할수 있는것도 이 투시 
의 우점이다. 


3. [ Project ] 보기 에서 sampleChap 6 프로젝 트를 열 고 rt.jar 를 선택 한다. 

4. [ Packages ] 보기에서 [ org . w 3 c . dom ] 을 선택하고 [ Types ] 보기에서는 [ Document ] 를 
선택하며 [ Members ] 보기에서 [ createElement ( string )] 을 두번찰칵한다(그림 6-3). 
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제 2 절 . [Hierarchy ] 보기 

Java 클라스나 대면의 계승관계를 조사할 때 편리한것이 [ Hierarchy ] 보기이다. 
[ Hierarchy ] 보기 를 현시 하기 위 하여 서 는 [Package Explorer ] 보기 에 서 형 (클라스나 
대 면) 을 선택한 다음 F 4 건을 누른다. 형 을 오른쪽찰칵— [Open Type Hierarchy ] 또 
는 차림표띠의 [ Navigate ] —[Open Type Hierarchy ] 에서도 [ Hierarchy ] 보기를 열수 
있다. 여기서는 [ Java ] 투시의 [Package Explorer ] 보기에서 [ SampleChap 6] 프로젝트 
— [JRE System Library ] —[ rt . jar ] —[ java , util ] 패 키 지 — [ ArrayList , class ] 를 선택 한 
다음 F 4 건을 눌러 그림 6-4 와 같은 [ Hierarchy ] 보기 를 현시한다. 그림 6-4 와 다른 경 
우는 [ Hierarchy ] 보기 의 [Show the Type Hierarchy ] 단추를 찰칵한다. 



그림 6-4. [Hierarchy ] 보기 


[ Hierarchy ] 보기의 웃부분에는 형사이의 계승관계(형 계 층)가 계 층구조로 현시된다. 
[ Hierarchy ] 보기 의 아래 부분에 는 [ Hierarchy ] 보기 에 서 선택 된 형 의 성 원 (마당이 나 메 
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쏘드 ) 이 목록으로 현시 된 다. [ Hierarchy ] 보기 의 도구띠 에 서 ▼단추를 찰칵 — [ layout ] 
에서 이 러한 2개의 부분화면을 나란히 배 치시 킬수도 있고 형계층만을 현시할수도 있다. 
이 미 열 려 진 [ Hierarchy ] 보기 에 서 AbstractList 를 오른쪽찰칵하여 [Focus on 
‘ AbstractList ’ ] 을 선택 하면 AbstractList 의 형계층이 현시된다(그림 6-5). 이와 같 
이 어 떤 형 에 초점 을 주면 그 형 에 부분형 이 존재하는 경 우에 는 모든 부분형 들을 현시할 
수 있다. 


Package Explorer 


Hierarchy : AbstractList 


然 」Unit 

ctlist 


因 


민 tt f 卜 


r 0 Object 

▽ © A A bstractC ol le cti on 


a AbstractList 



© A A bstra 산 S eq u e nti al Li st 
t> © Array Li 5t 
<S s ArravList 
© Array Queue 
<S s CopiesLi5t 
<S 3 COWSubList 
CS S Empty List 
I> © Freezable Li st 
0 s Index 


그림 6-5. AbstractList 의 형계층 

[Show the Supertype Hierarchy ] 단추를 찰칵하면 초점 이 있는 형 의 상위 형 만이 
현시된다. [Show the Subtype Hierarchy ] 단추를 찰칵하면 초점 이 주어져 있는 형의 
부분형 만이 현시 된다. [Previous Type Hierarchies ] 단추를 찰칵하면 현시 된 형 의 리 
력 이 현시 되 기때 문에 그로부터 선택 되 여 이전에 현시 되 였던 형 계 층을 다시 현시하게 할 
수 있다. [ Hierarchy ] 보기 에서 형을 선택하면 아래쪽의 화면에 그 형의 성 원이 현시된 
다. [ Hierarchy ] 보기 에 서 AbstractList 클라스를 선택 하여 현시 되 는 성 원목록에 서 
add ( object ) 메 쏘드를 선택 한다. 성원목록의 화면에 있는 [Lock View and Show 
Members in Hierarchy ] 단추를 찰칵하여 선택 된 상태 로 하면 [ Hierarchy ] 보기 에 서 
add ( object ) 메쏘드가 어느 클라스에서 덧 쓰기 ( overwrite ) 되였는가가 현시된다 (그림 
6-6). 성 원목록화면의 웃부분에는 그밖에 표 6-1 에 제시한 단추들이 있어 현시시 킨 대 
상을 교체할수 있 다. 
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그림 6-6. [Lock View and Show Members in Hierarchy] 단추를 선택한 경우 
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표 6-1. 


성원목록화면의 단추 


단 추 

단추를 눌렀울 때의 현시 


Lock View and Show Members 선택 된 성 원을 [ Hierarchy ] 보기 에 현시 한다. 
in Hierarchy 


Show All Inherited Members 

Sort Methods by the Defining 
Type 

Hide Fields 

Hide Static Fields and Methods 


선택되여있는 클라스에 정의되여있는 성원만이 아니 
라 어미클라스에서 정의되 여있는 성원도 현시 한다. 

메쏘드의 되돌림값의 형으로 메쏘드를 정렬하여 
현시 한다. 

마당이 현시되지 않게 한다. 

static 인 마당이 나 메 쏘드를 현시하지 않게 한다. 


Static 


Hide Non-Public Members public 마당이 나 메 쏘드만을 현시하게 한다. 


지 금까지 [ Hierarchy ] 보기를 열 었을 때 에 형 을 하나만 선택할수 있었 다. 또한 패 
키지 나 서류철에 대 하여서도 형 계층을 현시 할수 있다. [Package Explorer ] 보기 에서 
[ SampleChap 6] 프로젝트ᅳ [ test ] 서류철을 선택 하고 F 4 건을 누르면 그 서류철내의 모든 
클라스에 대 하여 형계층이 현시된다(그림 6-7). 서류철 이 나 패 키지의 형계 층을 현시한 
경우는 선택된 서류철 또는 패키지안의 형들에는 풀색표식，그 이외의 형에는 백색표식 
이 붙는다. 



그림 6-7. 패키지전체의 형계층현시 

차림 표띠 의 [ Window ] — [Open Perspective ] — [ Others ] 를 선택 하여 현시 된 대 화 
칸에서 [Java Type Hierarchy ] 을 선택 하면 [Java Type Hierarchy ] 투시 가 열 린다(그 
림 6-8). 또한 지 름차림 표의 [Open Perspective ] 단추로도 [Java Type Hierarchy ] 
투시를 열수 있다. 이 투시는 [ Hierarchy ] 보기와 편집기 령 역 으로 단순한 구성 을 이루 
기 때 문에 형 계 층을 찾으면서 원천코드를 참조하는데 편리하다. 


144 


錢變邊 錢變變繼繼繼 

















세 6 장. JDT 到 요音4 44병 


1 &_ 和 W ， « ， ii，h &«pn 

，설 一 ◎，%■ JC m Q- 는 ， 


6- «—* a_ 

■ ■ - i ■■ 



그림 6-8. [Java Type Hierarchy ] 투시 


제 3 절. Java 검색，선언의 참조 

차림표띠에서 [ Search ] ᅳ [ Java ] 를 선택하면 그림 6_9와 같은 대화칸이 현시된다. 
[Java Search ] 태브에서 문자렬을 지정하여 클라스나 마당의 선언，참조하려는 위치 등 
을 검색할수 있다. 검색대상목록을 표 6-2 에，검색대상의 제한목록을 표 6-3 에，검색범 
위를 표 6-4 에 주었다. 

々 File Search | 난 Help Search| 因， Java Search |_ 

Search string C = any string, ? = any character): 

IjavaJang.Object 

Search For Limit To 

® Type O Method O Package 

O Constructor O Field 


Scope 

(•) Workspace ◦ 

pct&d : fissou 

O Enclosing Prqjects 


O Working Set 



Choose... 



O Declarations O implementors 

® References ◦ All Occurrences 

O O 

□ Search the JRE system libraries 


Hn 


Case sensitive 


Customize... 


Search 



그림 6-9. [Java Search ] 대화칸 
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표 6-2. 


[Search F 아]그룹의 선택항목들 

선 택 항목 

설명 



Type 

Method 

Package 

Constructor 

Field 

[Search string] 에 입력한 이름의 클라스 또는 대면부를 검색 
[Search string] 에 입력한 이 름의 메 쏘드를 검 색 

[Search string] 에 입력한 이 름의 패 키 지 를 검 색 

[Search string] 에 입력한 이 름의 구성자를 검 색 

[Search string] 에 입력한 이름의 마당을 검색 

표 6-3. 

[Limit To ] 그룹의 선택항목들 

선택항목 

설 명 

비고 

Declaration 

클라스，메쏘드，마당들이 
정의되 여있는 위 치를 검색 


Interface 

대면을 실현하고있는 클라 

[Search For ] 그룹에서 [Types)] 을 선 


스를 검색 

택하였 을 때 만 유효 

Reference 

클라스，메쏘드，마당 등 
이 사용되고있는 위치를 
검색 


All 

선언，구현，참조의 모든 


Occurrennces 

것을 검색 


Read Access 

마당을 참조하고있는 위치 

[Search For] 그룹에서 [Field] 을 선택 


를 검색 

할 때만 유효 

Write Access 

마당을 변화시키고있는 위 

[Search For] 그룹에서 [Field] 을 선택 


치를 검색 

할 때만 유효 

Search JRE 

검 사할 때 JRE 체 계 서고를 

[Limit To] 그룹에서 [Reference] 

System 

검색범위에 포함 

[All Occurrennces] 를 선택하였 을 때 

Libraries 


만 설정가능 


표 6-4. 

[ Scope ] 그룹의 선택항목들 

선택항목 

설 명 

Workspace 

Selected Resources 

Enclosing Project 

Work Set 

현재의 작업공간전체를 검색 

현재 선택된 자원만을 검색 

현재 선택 된 자원 이 포함되 여있는 프로젝 트전체 를 검 색 

선택된 작업조에서 정의된 범위를 검색(작업조에 대하여 
서는 6 장의 제 4 절 작업조를 참고) 
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[ Java ] 투시 의 [Package Explorer ] 보기 에 서 [ SampleChap 6] 프로젝 트를 선택 한다. 
앞에서 본 방법 대 로 차림 표에서 [Java Search ] 래 브를 열고 SampleChap 6 프로젝 트에서 
TestCase 클라스가 참조되고있는 장소를 검색해보기로 한다. 그러자면 [Java Search ] 
태브의 [Search String ] 마당에 《 TestCase 》 를 입력하고 [Search For ] 그롭에서 
《 Types 》 을 선택 한다. 

[Limit To ] 그룹에서 [ References ] 를 선택하고 [ Scope ] 그룹에서 [Selected 
Resoures ] 을 선택 한다. [ Search ] 단추를 찰칵하면 검색 이 시 작되 여 [ Java ] 투시의 오른 
쪽아래의 [ Search ] 보기에 결과가 현시된다(그림 6-10). [ Search ] 보기의 [Next 
Match ] 단추나 [Previous Match ] 단추를 찰칵하면 검색 에서 대조된 부분의 원천코드가 
편집기에 현시된다. 이때 대조된 문자렬이 반전현시되는데 그 행이 노란색의 화살표로 
제시된다. [ Search ] 보기의 검색결과는 프로젝트， Java 패키지，파일，형들로 그롭화되여 
있 다. 각각 [Group by Project ] , [ Group by Package ], [Group by File ], [Group 
by Type ] 의 단추를 찰칵하는것으로서 그롭들사이의 절환을 실현할수 있다. 



그림 6-10. 검색결과를 현시하는 [Search ] 보기 

검색은 지름차림 표에서도 진행 할수 있다. 여 기서는 DisplayObject 대면을 실현하고 
있는 클라스를 검색하여 본다. [Package Explorer ] 보기에서 [ SampleChap 6] 프로젝트 
[ src ] 서 류철 [ sample , hello ] 패 키 지 — [ DisplayObiect . Java ] [ DisplayObiect ] 를 
선택 하고 마우스오른쪽단추를 찰칵한다. 이때 현시 되 는 지 름차림 표에서 [ References ] 
— [ Workspace ] 를 선택 하면 작업 장에서 DisplayObject 를 실현하고있는 클라스가 검 색 
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되여 검색결과가 검색보기에 현시된다. [ Outline ] 보기에서 DisplayObject 를 오른쪽찰 
칵하여 [ References ] 수 [ Workspace ] 을 선택하여 도 꼭같이 검 색할수 있 다. 

[Java Search ] 를 사용하면 마당이 나 형 이 선언되 여 있는 위 치 를 검 색 하는것 이 가능하지 
만 선언을 검색할 때에는 보다 편리한 방법이 있다. [Package Explorer ] 보기에서 
[ SampleChap 6] 프로젝 트— [ src ] 서 류철 — [ sample , hello ] 패키지 — [ Employee . Java ] 를 두 
번찰칵하여 원천코드를 현시한다. Implements 구문의 [ DisplayObject ] 를 선택하고 마우 
스오른쪽단추를 찰칵하고 [Open Declaration ] 를 선택하면 DisplayObject 가 정의되 여 
있는 원천코드가 Java 편집기에 현시된다. 메쏘드나 마당에 대하여서도 이와 같이 하여 
원천코드에서 정 의 되 여있는 장소를 검 색 하고 그 부분을 편집 기 에 현시할수 있다. 

또한 선언부분의 원천코드를 참조하기만 한다면 Java 편집기에서 형(또는 메쏘드나 
마당)우에 마우스지 시 자를 맞추었을 때 나타나는 튀여 나오기 창에 원천코드를 현시할수 
있다. 또한 Java 편집기에서 선언을 참조하는 형이나 메쏘드에 마우스유표를 이동시키면 
[ Declaration ] 보기에 대상의 원천코드가 현시된다(그림 6-11). 선언에서 정의된 
Javadoc 는 [ Javadoc ] 보기에 현시된다(그림 6-12). 원천코드가 첨부되여있다면 건립 
경로에 포함되여있는 서고의 원천코드나 Javadoc 도 참조할수 있다. 이 기능들을 사용하면 
참조만을 하려는 경우에는 Java 편집기를 열지 않아도 된다. 이렇게 Java 편집기에는 편집하 
려는 코드만을 현시하게 함으로써 필요없이 코드들을 변경시키는것을 막을수 있게 된다. 
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그림 6-12. Javadoc 의 현시 


제4절. 작업조 

작업 조 (working set ) 를 사용하면 보기 에 서 현시하려 는 요소를 제 한할수 있 다. [Ja 
va ] 투시를 열고 [Package Explorer ] 보기의 ▼단추를 찰칵하여 [Select Working Se 
幻 을 선택하면 그림 6-13 과 같은 대 화칸이 열린 다. 

텔^ x | 

5elect a working set: 


오 iew … 


Cancel 


그림 6-13. 작업조의 선택 


[ New ] 단추를 찰칵하여 새 로운 작업 조를 설정하는 대 화칸이 열린다 (그림 6-14). 
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그림 6-14. 작업조설정대화칸 1 

여 기서 [Working set type] 의 [Java] 를 선택한 다음 [Next] 단추를 찰칵한다. 
[Java Working Set] 대 화칸의 [Working set name] 에《 Samplesrc》 을 입 력 하고 [W 
orking set content] 에 서 [SampleChap6] 프로젝 트를 열 어 src 서 류철 만을 선택 한다 (그 
림 6-15). 


Java Working Set 

Enter a working set narr 


i and select the working set elements. 


산 


| SampleSrc 

]i 

Working set content: 



r H 던 SampleChap6 
t> 00src 
t> □(경 test 

0 □효 rt.jar - /Companero-1.2^jdkl.6.0(ire/lib 

t> □ 훌 jsse.jar - /Companero-1.2^jdkl.6.Q(jre/lib 

> □ ^jce.jar - /Companero-1.2/jdkl.6.0(jre/lib 

t> n^charsets.jar - /Companero-1.2^jdkl.6.0/jre/lib 

t> [IS sunpkcsll.jar - /Companero-1.2^jdkl.6.0/jre/lib/ext 

1> []fi sunjce_provider.jar • /Companero>1.2 刀 dkl.6.0 신 re 川 IVext 

t> dnsns.jar - /Companero-1.2^jdkl.6.(yjre/lilVext 

卜 []fi localedata.jar - /Companero-1.2^jdkl.6.(yjrG/lib/ext 

0 nS IUNIT HOME/iunit.iar - /ComDanero-1.2/Dluoins/ora.iunit 3.8.1/iunit.iar 


< Back | | I Hnish | | Caned 


그림 6-15. 작업조설정대화칸 2 
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[ Finish ] 단추를 찰칵하면 작업 조의 선택 화면 에 돌아가 이 미 작성 된 SampleSrc 가 
목록에 현시 된다. 작성 된 작업 조를 선택하여 [ OK ] 단추를 찰칵하면 [Package 
Explorer ] 보기에는 이미 [Working set content ] 에서 선택된 내용만이 현시되게 된다 
(그림 6-16). 원래대로 되살리기 위해서는 [Package Explorer ] 보기의 ▼단추를 찰칵 
하여 [Deselect Working set ] 를 선택한다. 


我 Hierarchy 


JUrat 


白 


솔 s♦ 


B 爲 


r l^SampleChapB 
▽ i3src 

▽ ffl sample.hello 

I> 函 Display Object.java 


Employee java 


I> 2) EmployeeMapjava 

I> 0] EmployeeMapFactory.java 


I> 田 Hello.java 

t> 2) HelloEmployee.java 

I> 因 XmlUtiLjava 


그림 6-16. 작업조작성 후의 패키지열람기 

작업 조의 작성은 [Package Explorer ] 보기 뿐만아니 라 [ Navigator ] 보기와 [ Task ] 
보기의 현시대상을 조절하려고할 때에도 리용한다. [Java Search ] 에서 [ Scope ] 의 설정 
을 [ Workspace ] 으로 하였을 때 와 [Working set ] 으로 설정 하였을 때 java . util . Map 
의 참조를 검 색하여 결과의 차이 를 확인해 본다 (그림 6-17) . 

작업조는 모든 보기에서 다 설정할수 있으며 어떤 보기에서 작업조를 설정한것이 다 
른 보기 에 영 향을 주지 않는다. 또한 작업 조를 설정한 후에 추가되 는 요소가 기 존요소의 
하위 요소이 면 자동적 으로 추가되 지 만 그렇 지 않는 경 우는 작업 조를 편집하여 추가하지 
않는 한 자동적으로 추가되지 않는다. 
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，Rle Search | g'Help Search 벽 '」 ava Search 


Search string ( A = any string, 7 = any character): 

|javautiLMap ᄆ □ Case sensitive 


5earch For 

® IVP e O Method O Package 
O Constructor ◦ Rdd 


Limit To 
O Declarations 
公 ) References 

◦ R 빼 A 편며 

□ Search the JRE system libraries 


O Impiementors 
O All Occurrences 

o 


Scope: 

O Workspace ◦ Selected Resources O Enclosing P’r 던 sets 

® Woridng Set: SampleSrc Choose... 


CkistomSze... 


Search 

Caned 


그림 6-17. [Java Search ] 에서 작업조를 사용 


제 5 절 . 문자렬의 외부화 

특정한 나라나 지역에서만 사용하는 응용프로그람이면 차림표나 통보문을 그 나라나 
지역에서 사용하고있는 언어로 현시해도 별문제가 없겠지만 여러 나라들이나 지역에서 
사용되는 응용프로그람이면 매개 언어에 대응할 필요가 있다. 또한 언어만이 아니라 날 
자의 표기에서도《1 April 2003》과 같이 《일，월，년》의 순서인 경우나《2003년 4 
월 1일》과 같이〈〈년，월，일》순서로 된 경우 등 나라마다 차이가 있다. 응용프로그람을 
여러 나라의 언어，화폐와 수값 등에 대응시키는것을 응용프로그람의 외부화라고 한다. 

외부화시켜야 할 응용프로그람에서는 나라나 지역에 맞추어 화면에 현시되는 통보문 
이 나 차림 표，단추의 명 칭 등을 절환시킬 필요가 있다. 또한 원천코드에 이 문자렬들이 
직 접 넣 어져있으면 언어마다 다른 원천코드가 필요하게 된다. 이것을 극복하기 위해 나 
라나 지 역 별로 속성파일을 준비하여놓고 응용프로그람은 속성파일에서 문자렬을 취 하도 
륵 하는것 이 일 반적 인 수법 으로 되 고있 다. Eclipse 에 서 《 문자렬의 외 부화》를 사용하여 
원천코드를 수정 하는것 은 조수를 리 용하면 간단히 진행 할수 있 다 

Java 투시의 패 키지열 람기 에서 [SampleChap6] 프로젝트를 오른쪽찰칵하여 

[Source] ᅳ [Externalize Strings] 을 선택하면 그림 6_18 과 같은 문자렬 이 들어있는 
원천코드의 목록이 현시된다. 이 목록에서 《 Hello.Java 》 를 선택하고 [Externalize] 
를 찰칵하면 그림 6-19 와 같이 문자렬의 외부화조수대화칸이 현시된다. [String to 
externalize] 에 서 행 을 선택 하면 [Context] 령 역 에 원천코드의 할당부분이 반전현시 되 
기때문에 어떤 문자렬이 외부화되고있는가를 확인할수 있다. 


152 錢變邊錢變變繼繼繼 


































세 6 장. JDT 到 요音4 44병 



그림 6-18. 외부화하려는 문자■의 선택 


절 

Externalize Strings m 'Hello.java 1 


■豆!교 I 

딱 _ 


Enter common prefix for generated keys CoptionalJ: B 田 IP1 


Strings to externalize: 0 Rlter ail existing igrvoFect and extemaJjzed entries 


— 卜으 : 

l“ — 

Extern ： a3ize 

0 Hello 

Cont€Ktr 

Hello.0 

ignore 

Internalize 






Revert 





/* 

食 

* 

A 



美 

요 

*/ 

package sample-hello; 







[귀 

nn — 


IH 


Accessor class: 

Properties file: 



5 am pje. hdlo. Mes s ages 

j S am pJeChap€/s rc/s am p]e/he] 1 mes sages. properties 

Configure... 


N：ext > 


Cancel 


그림 6-19. 문자렬의 외부화조수대화칸 
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대화칸의 바로 아래에 호출기클라스와 속성파일의 이름이 현시된다. 기정현시되는 
클라스나 속성파일을 변경하려 는 경우에는 [ configure ] 를 찰칵한다. 여 기서 는 기정클라 
스와 속성파일을 그대 로 리 용함으로써 [ Next ] 단추를 찰칵한다. 경 고할 문제 가 제 기되면 
대화칸(그림 6-20) 에 통보문이 현시되며 특별히 문제가 제기되지 않으면 이 대화칸은 
현시되지 않는다. [ Next ] 단추를 찰칵한다. 



Externalize Strings in 'Hello.java' 

Review the information provided in the list below. Click 'Next' to view the next item or ’Finish'. 

醜 IS 

Found problems 

# 會 


i Property file '/SampleChapS/src/sample/hello/messages.properties' does not exist and will be created. 


No context information available 


< Back 

Next > 

Rnish 

Cancel 


그림 6-20. 경고틍보문의 현시 

다음 대화칸에서는 원천코드에서의 변경된 부분을 사전에 확인할수 있다 ( 그림 
6-21) . 확인한 다음 [ Finish ] 단추를 찰칵한다. 그러 면 [Externalize Strings ] 대 화칸 
이 현시 되 는데 [ Close ] 단추를 찰칵하면 된 다. 


154 


錢變邊 錢變變繼繼繼 






















세 6 장. JDT 到 요音4 44병 



그림 6-21. 변경이 진행된 원천쿄드의 확인 

이상의 조작에 의해 Hello . Java 에 변경이 진행되며 Messages . Java (목록 6-1) 와 
Messages . Properties (목록 6_2)의 2개 파일이 작성된다. 이 변경으로 하여 문제가 발 
생 하지 않는가를 확인해 보기 로 한다. [Package Explorer ] 보기 에 서 [ SampleChap 6] 프 
로젝 트ᅳ [ test ] 서 류철 ᅳ [ sample , hello ] 패 키 지 ᅳ [ HelloTest . java ] 를 선택 하고 마우스 
오른쪽단추를 찰칵한다. 현시 되 는 지 름차림 표에 서 [ Run ] —[Junit Test ] 을 선택 하여 실 
행시켜 본다. 

목록 6-1. Messages.java 

/* 

* 작성날자 2005년: XX 월 XX 일 
* 

* TODO 이 생성된 파일의 형판을 변경하기 위해 뛰여넘기: 

* 창문-설 정 - Java - 코드격 식 -코드형 판 
*/ 

package sample . hello ； 

import java , util . MissingResourceException ； 
import java . util . ResourceBundle ； 

/* 

*9 auther 
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* 

* TODO 이 생성된 t 형해설문의 형판을 변경하기 위해 뛰여넘기: 
* 창문-설 정 - Java - 코드격 식 -코드형 판 
*/ 

public class Messages { 

private static final String BUNDLE _ NAME = 

“ sample , hello , messages ” ;// $ NON _ NLS _ l $ 
private static final ResourceBundle Resource _ BUNDLE = 
ResourceBundle . getBundle ( BUNDLE _ NAME ) ； 
private Messages () { 

} 

public static String getString (String key ) { 

// TODO 자동생성된 메쏘드 
Try { 

return Resource _ BUNDLE . getString ( key ) ； 

} catch (MissingResourceException e ) { 
return ‘ ! ’ + key + ‘ ! ’ ； 


목록 6-2, messages.properties 

Hello . 0 =Hello 


문자렬의 외부화를 취소하기 위해서는 차림표띠에서 [ Refactor ] ᅳ [ Undo ] 를 선택 
한다. 실제 로 실행하여 원래 대 로 되 는가를 확인하여 본다. 

우의 례 에서는 외부화하는 문자렬에 영 문자밖에 포함되지 않았다. 조선어 나 한자， 
일본어같이 ASCII 문자외의 문자가 속성파일에 서술되여있는 경우에는 《/ udddd 》 의 형 
식으로 표기되는 Unicode 문자를 사용해야 한다 . ( J 2 SE 의 SDK 에 부속되여있는 
native 2 ascii 라는 도구를 사용하면 민족코드의 파일을 Unk : ode 문자로 변환할수 있다. 
또한 - reverse 선택항목을 붙혀서 그 반대 ( Unicode 전위문자—민족코드)의 변환도 진행 
한다.) 

Eclipse 의 [Externalize Strings ] 를 사용하여 조선어문자렬을 외부화하면 자동적 
으로 Unicode 전위 문자에로의 변환도 진행된다. [Package Explorer ] 보기에서 
[ SampleChap 6] 프로젝 트— [ src ] 서 류철 [ sample , hello ] 패키지 — [ Employee , java ] 를 오른 
쪽찰칵하여 [ Source ] —[Externalize Strings ] 를 선택하면 문자렬의 외부화대화칸이 현시된 
다(그림 6-22) . 열쇠 [ Employee . 이의 값이 [종업원 ID =] 인가를 확인해본다. 다음 
[ Next ] 단추를 찰칵하여 확인화면까지 나간다. 확인화면의 [Changes to be performed ] 
에서 [Create file ：/ SampleChap 6 / src / sample / hello / messages . properties ]- f - 선택 
하여 messages . properties 의 내용을 현시한다(그림 6-23). 
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Externalize Strings in 'Employee.java' 


^ ■因[경 

Til. 


Enter common prefix for generated keys (optional): 3SHEB3 



Context: 


" 



스 








U 

*/ 




package sample.hello ; 



- 

<1 

Accessor class: 

Properties file: 




I sample.hello.Messages| [SampleChap6/src/sample/hello/messages.properties J | Configure.. 


Next > | | | | Caned 


그림 6-22. 조선어문자렬의 외부화 




그림 6-23. 조선어문자■을 포함하는 속성파일 
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Employee . 3은 [전화번 호 =] 라는 문자렬 이였 으나 [전화번 히 가 

《 / u 96 FB / u 8 A 71/ u 756 A / u 53 F 7 》으로 변화되는것을 확인할수 있다. 이렇게 하여도 
프로그람의 실행에서는 지장이 없지만 속성파일의 읽기를 쉽게 하기 위하여 열쇠에 의미 
가 있는 이름을 달아주는것이 좋다. 그림 6-22 의 대화칸에서 열쇠를 선택한 다음 
[ Edit ] 단추를 찰칵하여 현시되는 대화칸에서 열쇠의 문자렬이 나 대응하는 값을 직접 편 
집할수 있 다. 


제6절. 오려돋책 ( scrapbook ) 

오려둠책을 사용하면 완전한 클라스의 원천코드를 작성하지 않고도 코드의 어떤 토 
막만을 실행시킬수 있다. 

오려둠책를 사용하기 위해서는 먼저 오려둠책을 작성하여야 한다. 차림표띠에서 
[ File ] ᅳ [ New ] ᅳ [ Others ] 를 선택하여 현시 된 대 화칸에 서 [ Java ] ᅳ [Java 
Run / Debug ] —[Scrapbook Page ] 를 선택 한 다음 [ Next ] 단추를 찰칵한다. 그러 면 그 
림 6-24 와 같은 대화칸이 현시된다. 



그림 6-24. 오려■책페지의 새로 작성 

SampleChap 6 프로젝트를 선택한 다음 [File name ] 마당에 《 myscrap 》 라고 입력 
하고 [ Finish ] 단추를 찰칵한다. 그러 면《 myscrap . jpage 》 라는 빈 편집 기 가 열 린 다. 이 
편집 기 에 목록 6-3 의 코드토막을 입 력한다. 
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목록 6-3. 

sample , hello . Hello hello=new sample , hello . HelloO ； 
System . out . println ( hello . getgreeting ( “***” )); 


입 력된 코드토막전체를 선택 하고 오른쪽찰칵하여 [ Run ] 을 선택한다. 코드토막이 
실행되 여 console 보기 에 [Hello ***] 라고 현시된다. 객체 나 값을 되돌려주는 메 쏘드의 
되 돌이 값을 안다면 console 보기 에 출력하는 코드를 쓰지 않고도 지 름차림 표에 서 
[ Checkout ] 나 [ Display ] 를 선택 하여 비 교해 볼수 있 다. 이 와 같이 오려 둠책 은 여 러 행 
의 원천코드를 시험적으로 실행하여보려고 하는 경우에 사용할수 있다. 


제7절. 표준쿄드작성 

한 사람이 작성하는 프로그람이라면 코드작성격식은 별로 문제될것이 없다. 자신의 
의도에 맞는 격식으로 코드작성을 하면 그만이다. 원천코드가 어떻든 구문적으로 차이가 
없는 한 아무런 문의도 없이 를파일이 진행된다. 그러나 쏘프트웨어개발프로젝트의 성원 
으로서 프로그람을 작성 하는 경우에는 프로그람작성 자에 따라 코드작성격식 이 차이 나는 
데 이것은 문제 로 된 다. 

림으로 개발하는 경우 다른 사람이 작성한 코드를 읽을 필요가 제기된다. 이때 코드 
작성형태가 각이하면 코드를 읽기 힘들고 다시 보는데 시간이 더 많이 소모되는 등 여 러 
가지 결함들을 피할수 없게 된다. 프로젝트에서 코드작성표준을 정해놓으면 모두가 표준 
에 따라 코드작성을 함으로써 림전체의 개발능률을 높일수 있다. 개발수법의 하나인 
XP(extreme Programming ) 수법에서는 코드작성표준이 실현되여 있다. 여기서는 코드 
작성 표준화를 지 원 하는 Eclipse 의 기 능에 대 하여 소개한다. 


6.7.1. 코드서 식 기 (code formatter) 

[ Preference ] 대 화칸에 서 Eclipse 가 자동생 성 하는 코드나 Javadoc , 서 식 화 
( format ) 를 진행할 때 에 적용되는 코드작성격식을 지정할수 있다. Eclipse 3.0 에서는 
이전 보다 코드서식기가 더 강력해졌으며 세밀하게 설정할수 있게 되였다. 

코드서식기의 설정은 [ Preference ] 대화칸에서 진행 한다. 차림 표띠 에서 [ Window ] 
— [ Preference ] 을 선택 한다. 현시 되 는 대 화칸의 왼쪽에서 [ Java ]— [Code style ] ^ 
[Code Formatter ] 를 선택 한다(그림 6-25). 
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그림 6-25. 쿄드서식기의 설정대화칸 

기정 으로는 프로파일로서 [Java Conventions [ built - in ]] 이 선택되 여있다. 이 밖 
에 [Eclipse 2.1 [built in ]] 을 선택할수 있다. 선택한 프로파일에 의해 어떻게 서식화되 
는가는 [ Preview ] 에서 확인할수 있다. 이 밖의 서식화를 진행 하려는 경우에는 새롭게 
프로파일 을 정 의할수 있 다. 그러 자면 대 화칸에 서 [ New ] 단추를 찰칵하여 그림 6-26 의 
대화칸을 연다. 



그림 6-26. 새로운 프로파일의 작성 

[Profile name ] 에 《Sample Profile 》 을 입 력 하고 [Initialize settings with the 
following profile ] 에서 《Java Conventions [ built - in ] 》을 선택 한 다음 [ OK ] 단추 
를 찰칵한다. 이상의 설정 으로 기정의 Java 규약을 기초로 프로젝트의 코드작성표준에 
맞도륵 서식기를 설정하였다(그림 6-27). 
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그림 6-27. 코드서식기에서 프로파일의 편집 

그림 6-27 에서 설정을 변경하려는 태브를 선택하고 화면의 현시에 따라 변경한다. 
거의 대부분의 항목을 검사칸의 선택이나 내리펼침목록의 선택으로 설정할수 있다. 어떻 
게 서 식 화되는가는 매 태 브에 있는 [ Preview ] 령역 에서 확인할수 있다. 

표 6-5 에 설 정 가능한 항목들가운데 서 일 부를 소개하였 다. 


표 6-5. 


코드서식기 프로파일의 설정항목 


태브이름 


설정 내 용 


Indentation 

Braces 

White Space 
Blank Lines 

New lines 
Control Statements 
Line Wrapping 

Comments 


들여쓰기 에서 사용하는 공백의 수，들여쓰기 에 태브를 사 
용하는가，들여쓰는 위치의 설정을 진행 
블로크시 작을 나타내는 괄호의 설정 (선언과 같은 행，선언 
의 다음 행 등) 

공백 의 설정 ( if 와 괄호사이 에 공백 을 넣 는 등) 

공백행 의 설정(패 키 지 선언의 다음，메 쏘드선언하기 전에 
공백행을 넣겠는가 하는 위치설정과 그 행의 개수설정) 

빈 블로크나 배렬초기화에서의 행바꾸기설정 

조종명 령 문 (if else , try-catch 등) 의 행바꾸기 설 정 

한 행 의 최 대 문자수설 정 이 나 최 대 문자수를 넘 어 날 때 행 바 

꾸기의 설정 

설명문부분의 서식설정 
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그림 6-28. [ Braces ] 태브의 설정 


여기서는 클라스나 메쏘드의 정의나 
if-else 문， try - catch-finally 문 등의 블로 
크를 표시하는 중괄호(〈〈 {», 《}》)의 앞 
뒤 에서 행바꾸기 를 설정하였다. 그림 6-27 
의 대 화칸에 서 [ Braces ] 태 브를 선택한다. 

여 기서 [Array initializer (배 렬초기 화기 )] 

를 제외한 나머지는 [Next line ] 으로 변경 
시킨다(그림 6-28). 

다음으로 [Control statements ] 래 브 
를 선택하고 [ General ] 그롭에서 [Insert 
new line before ’ while ’ in a ’ do ’ 
statement (’ do ’ 명 령 문안의 ’ while ’ 명 령 
문의 앞에 행바꾸기 를 삽입 )]을 제 외 하고 
나머 지 는 모두 선택한다(그림 6-29). 

[ OK ] 단추를 찰칵하여 설정 대 화칸을 닫고 
프로파일 에 [Sample Profile ] 이 선택 되 여 
있는가를 확인한 다음 [ Preference ] 대화 
칸도 닫는다. 

서식기를 실행하기 위해서는 차림표에 

서 [ Source ] —[ Format ] 또는 [Package Explorer ] 보기를 오른쪽찰칵— [ Source ] — 
[ Format ] 을 선택 한다. [Package Explorer ] 보기 에서 프로젝 트나 원천서 류철 을 선택 한 
경우에는 그의 자원에 포함되는 원천코드전체가 서식화된다. 한개의 원천코드를 서식화 
한 경우에는 차림표띠의 [ Edit ] —[ Undo ] 를 반복하는것으로서 원래대로 되돌려 보낼수 
있지 만 여 러 개의 원천코드에 대 하여 서 식화를 진행하였으면 서식 화전의 상태 로 되돌아가 
지 않는다. 서식화를 실행하기 전에 경고통보문이 있기때문에 그 시점에서 중지할수 있 
다는데 주의 를 돌려야 한다. 

[Package Explorer ] 보기에서 [ SampleChap 6] 프로젝트 [ src ] 

[ EmployeeMapFactory . java ] 를 선택 하여 우와 같은 순서 로 서 식 화를 실 행 하여 본다. 
이미 설정된 프로파일에 따라 서식화되는가를 확인해보아야 한다. 

림 전체가 같은 코드작성표준에 따라 작성하기 위해서는 모두가 같은 서식화프로파 
일을 사용하면 된다. Eclipse 에서 설정한 서 식 화프로파일은 XML 격 식 으로 반출，반입할 
수 있다. 반출이 나 반입 을 진행 하려면 [ Preference ] 대 화칸의 [Code Formatter ] (그림 
6-25) 에 있는 [ export ] 단추나 [ import ] 단추를 사용한다. 이 단추를 리 용하여 림 에서 
같은 서식프로파일을 사용하며 CVS 등의 보관고에서 선택하기 전에 반드시 Eclipse 의 
코드서 식 기를 일 치시키는것 이 좋다. 
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그림 6-29. [Control statements ] 태브의 설정 


6.7.2. Eclipse Checkstyle Plug-in 

코드작성표준에는 들여쓰기나 행바꾸기 등의 규칙외에 메쏘드이름이나 마당이름 등 
의 이름짓기규칙이 포함된다. Eclipse 의 코드격식의 설정에서는 이름짓기규칙을 위한 처 
리를 강제로 할수 없다. 그러나 [Preference] 대화칸의 [Java] —[Code style] 에서 변 
수의 앞불이나 뒤붙이의 이름규칙을 설정할수 있다. 이름짓기규칙의 검사에 리용할수 있 
는 도구로서 Checkstyle (http : // checkstyle. sou reef orge. net/ ) 이 있 다. 

Checkstyle 을 사용하면 이 름짓 기 규칙 만이 아니 라 들여 쓰기 나 행 바꾸기 등의 코드작성 
표준건반에 관한 검 사를 할수 있 다. Checkstyle 을 Eclipse 에 서 실 행할수 있게 하는 추 
가쏘 프트웨 어 가 Eclipse Checkstyle Plug-in (http :// eclipse-cs. sourceforge. net/) 
이 다. Checkstyle Plug-in 은 검 사대 상을 프로젝 트단위 로 설정한다. 

여기서는 SampleChap6 프로젝트에서 Checkstyle 을 사용해보기로 한다. 실현방법 
은 다음과 같다. 

① Java 투시의 [Package Explorer] 보기에서 [SampleChap6] 을 오른쪽찰칵하여 
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나타나는 차림표에서 [ Properties ] 을 선택한다. 그러면 프로젝트의 속성설정대 
화칸이 열린 다. 

② 대 화칸에 서 [ Checkstyle ] 을 선택한다. 

③ 대 화칸의 오른쪽에 있는 [ Add ] 단추를 선택한다(그림 6-30). 



그림 6-30. SampleChap 6 의 속성설정화면 


④ [Checkstyle File Set Editor ] 대 화칸 (그림 6_31) 에 서 [File Set Name ] 에 
《All Java resource 》 이라고 입력하고 [Check Configuration ] 에서 (Sun C 
hecks 》 를 선택한다. (기정으로는 [Sun Checks ] 밖에 선택하지 못한다. [Sun 
Checks ] 를 선택하면 Sun 의 코드작성 규약에 기 초하여 검 사를 진행한다. ) 
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그림 6-31. [Checkstyle File Set Edit 아]대화칸 
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⑤ 대화칸의 아래에는 검사대상으로 하는 파일표현형식을 정규표현으로 설정할수 있 
다. [ Add ] 단추를 찰칵하면 정 규표현을 추가할수 있 다. [ Test ] 단추를 찰칵하면 
어떤 파일이 검사대상으로 되는가가 목록으로 현시되므로 의도한대로 파일이 포 
함되 여있는가를 확인할수 있다. 여기서는 기정(파일 이름의 제 일 끝이 java 인 파 
일 ) 대 로 설 정 하고 [ OK ] 단주를 찰칵하여 대 화칸을 닫는다. 

⑥ 프로젝트의 속성설정대화칸에서 이자 등록한 파일묶음이 능동으로 되여 있는가를 
확인하고 [ OK ] 단추를 찰칵한다. 

우와 같은 설정에 의해 Checkstyle 이 자동적으로 실행되여 코드작성표준에 맞지 
않는 부분이 Java 편집기나 [Package Explorer ] 보기 등에 현시된다(그림 6-32). 실제 
로 여 러개의 원천코드를 현시하여놓고 어떤 경고가 나오는가를 확인하여 본다. 행마지막문 
자가 공백으로 되고 Javadoc 태그가 없는 등 세밀한 구문까지 검사한다는것을 알수 있다. 

[ Problems ] 보기 의 [ Filter ] 단추를 찰칵하면 현시 되 는 대 화칸에 서 [Show itmes of 
type ] 의 [Checkstyle Marker ] 에 선택표식 을 한 다음 [ OK ] 단추를 찰칵하면 
[ Problems ] 보기에 Checkstyle 의 경고가 현시된다. 
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그림 6-32. Checkstyle 의 경고 


錢變邊 0變變©繼鹽 


165 





































H 너•參於경 Eclipse 


Sun 의 코드작성규약이 아니라 프로젝트의 코드작성표준에 따르는 검사를 하고싶은 
경우는 Checkstyle 의 설정을 진행해야 한다. 차림표띠의 [Window] ᅳ [Preference] 에 
서 [Preference] 대 화칸을 열 고 Checkstyle 을 선택 한다 (그림 6-33) . 기 정 으로는 이 미 
설정한 [Sun Checks] 가 등록되 여있다. 



t> Install/Update 



> Lomboz 
t> Run/Debug 
t> Team 




| Checkstyle 一 

Checkstyle Settings: 

General Settings 

□ Include rule names in violation messages 


Check Configurations 


Check Configuration 

| ᅵ Add... | 

Sun Checks 

Import Plugin Config ... 1 Export Plugin Config ... 1 

Import Checkstyle Config ... Export Checkstyle Config ... 

| Edit... | 

| Copy... | 

Remove 


Import". 



그림 6-33. Checkstyle 의 설정 

럼에서 Checkstyle 을 리 용하고있고 작성한 Checkstyle 의 설정파일 이 있을 때 이 
대 화칸을 사용하여 반입하면 Eclipse 에 서 리 용할수 있 다. 이 경 우 [Import Checkstyle 
Config] 단추를 찰칵하여 설 정파일 을 읽어 들인 다. [Import Plugin Config] 단추는 
[Export Plugin Config] 단추를 사용하여 반출된 파일을 반입 하는 경우에 사용한다. 이 
것 은 Checkstyle 끼 워 넣 기 의 설정 이 원래 의 Checkstyle 설정 을 확장하고있는것 이 기 때 문 
에 림전체가 Eclipse Checkstyle Plug-in 을 리용하는 경우는 이것들을 사용하여 설정 
을 공유하는것 이 좋다. 

또한 [Export Plugin Config] 단추를 사용하면 Eclipse 의 외 부에 서 Checkstyle 
을 실 행하는 때 에 리 용하는 보통의 설 정파일 을 반출할수 있 다. [Add] 단추를 찰칵하여 
[Checkstyle Check Configuration Editor] 대 화칸을 열고 새 롭게 Checkstyle 의 검 사 
규칙 을 설 정할수 있 다 (그림 6-34). 

[Checkstyle Check Configuration Editor] 에서는 내 리 펼침목록으로부터 설정하 
는 항목을 선택할수 있는 등의 입력지원기능이 있고 원래의 Checkstyle 보다도 간단히 
검 사규칙 을 편집할수 있게 되 였 다. Sun 의 코드작성 규약을 토대 로 하여 프로젝 트용설정 
을 작성한것 이 면 Checkstyle 의 설정 대 화칸에 서 [Sun Checks] 를 선택하여 [Copy] 단 
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추를 찰칵한다. 이렇게 하면 [Sun Checks ] 의 검사규칙이 복사된 상태에서 
[Checkstyle Check Configuration Editor ] 가 열 리 기 때 문에 필요한 곳만 수정 할수 있 
어 품을 줄일수 있다. 기정의 [Sun Checks ] 에서 규약의 위 반은 경 고를 현시 하게 되 여 
있지만 이것을 오유로 현시하게 할수도 있다. 자세한 내용은 Checkstyle 의 설명서(도 
움말) 등을 참고한다. 



그림 6-34. 검사방식 및 검사구성편집기 
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제7장. 개 편 

제 1 절 . 개편의 정의 

개편 ( Refactoring ) 이 란 쏘프트웨 어의 외적거동을 그대 로 보존한 상태 에서 내부구조 
를 개선해나가는것을 말한다. 

구체적으로는 코드를 살펴보다가 길이가 긴 메쏘드，크기가 큰 클라스의 분할，리해 
하기 힘든 클라스，메쏘드이름의 변경，공통기능을 상위클라스에로 보내기와 같은 조작 
들을 진행하여 코드를 개 선하는것 을 말한다. 

보통 체계개발에서는 일단 완성되여 시험을 통과한 코드는 될수록 다치지 않고 수정 
할 필요가 생겨도 변경하지 않는 방법을 택하는것이 대부분이다. 이러한 환경에서 개편을 
적극적으로 하는것은 좀 어렵다. 그러나 최근에 주목되고있는 [ XP(eXtreme 
Programming )] 에서 개편의 실시가 적극적으로 제창되고있고 반복형의 개발수법이 일반 
적으로 쓰이게 됨 에 따라 개편도 자연히 개발작업의 일환으로 되여가고있다. 


제 2 절 . 개편에 필요한것 

7.2.1. 재귀시험묶음 

개편은 바로 코드의 수정 이다. 코드를 수정할 때 프로그람의 거동에는 변화를 주지 
말아야 한다. 이를 위하여《이 시험에서 합격하면 이 코드는 완전히 정확하다.》고 확신 
할수 있는 정 확한 시 험 묶음 (test suite ) 이 필 요하다. Eclipse 에 는 이 미 소개 된것 처 럼 단 
체시험도구인 JUnit 가 들어 있고 시험경우 (test case )/ 시험묶음 (test suite ) 의 작성지원 
기능이 갖추어져있을뿐아니라 Ant 기능과 조합하면 구축할 때마다 자동적으로 시험을 실 
행할수 있 다. 

7.2.2. 개편도구 

클라스나 마당，메 쏘드의 이 름 변경，메 쏘드의 파라메터 변경，다른 클라스에 로의 
메 쏘드의 이동과 같은 개 편을 진행 하기 위 하여 변경 할 요소가 들어있는 부분을 빠짐 없 이 
찾아내여 적절하게 변경시키야 하며 또한 많은 클라스를 다른 패키지로 이동하려는 경우 
package 문을 바꾸어쓸 뿐만아니라 원천파일을 파일체계에서 이동시키야 한다. 이와 같 
이 단순하면서도 시간이 걸리는 작업은 를퓨터에서 진행하는것이 제일 빠르고 정확하다. 
Eclipse 에 는 Java 문법 을 정 확하게 리 해 하는 성 능이 높은 검 색 엔진과 사용빈도가 높은 
개 편조작을 반자동화하는 개 편제 공기 능이 갖추어 져 있 다. 

회귀시험의 자동화를 지 원하는 JUnit 와 정 확도가 높은 개편을 진행할수 있는 도구 
를 갖추고있는 Eclipse 는 개 편을 적 극적 으로 진행 하기 위한 리 상적 인 개 발환경이 라고 
말할수 있다. 


168 錢變繼錢變變繼繼繼 






세 7 상. 개 4 


제3절. 개편의 실례 

Eclipse 의 개 편제 공기능을 충분하게 활용한 개 편조작에 대 하여 실례를 들어 설명하 
겠다. 이를 위 해서 SampleChapter7 프로젝트를 생성 하고 설명 을 진행 하도록 한다. 

7.3.1. StringEncoder 믈라스 

SampleChapter7 프로젝 트는 간단한 문자렬부호화기 (string encoder) 의 역 할을 수 
행하는 Java 프로젝트이 다. 이 부호화기는 문자렬을 받아서 그것 을 지정 한 방법 으로 변 
환하는 서고로서 요구사항은 다음과 같다. 

• Native2Ascii，ROT13( 자모순의 매 문자를 13문자 변경시키는 간단한 암호화방 
식)의 두 방식에서의 부호화에 대응해야 한다. 

• 새 로운 부호화방식 의 추가에 간단하게 대 처할수 있 어 야 한다. 

그때 기존부호화기의 원천코드에 손댈 필요가 없어야 한다. 

이 요구사항을 만족시키 는 작업 이 이 미 완성 되 고 부호화기 의 동작을 검 증하기 위한 
시험클라스도 준비되 여있다(표 7-1，그림 7-1). 


표 7-1. 


관련클라스일람 


클라스 


설 명 


StringEncoder 

StringEncoder. 

Encoder 

Native2Ascii 

Encoder 

ROT13Encoder 

StringEncoderTest 
Native2Ascii 
EncoderTest 
ROT 13EncoderT est 


부호화기의 API 정의 (가상메쏘드 “encode” ) 와 보조클라스의 
생성기능을 가진 추상클라스 
부호화방식을 나타내는 렬거형 (typesafe enum) 
NATIVE2ASCII 와 ROT13 이 정 의 되 여있 다. 

StringEncoder 보조클라스. native2ascii 지 령 과 같은 방법 으 
로 문자렬을 Unicode 조종문자로 변환하는 부호화기 
StringEncoder 보조클라스. ROT13 방식으로 문자렬을 암호화 
하는 부호화기 

StringEncoder 의 실례생성기능을 시 험한다. 
Native2AsciiEncoder 의 거 동을 정 의한다. 

ROT13Encoder 의 거 동을 정 의한다. 


EncoderMain 


부호화기의 리용실례. StringEncoder 를 사용하여 문자렬을 
부호화한다. 
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부호화기 의 API 를 규정 하고 있다. 

콜라 스를 생 성 하는 제 작소에 도 있 다. 



| +encoder(sir:String):Strir>9 | | 4-encoder(sir;String):String | 


Native 2 Ascii 지 령 과 같이 ^ 


간단한 암호화인 ^ 

문자렬 을 Unicode 화 한다 


ROT 13 을 작성 


그림 7-1. 개편전의 클라스도 


다음으로 부호화기 의 리용방법 에 대 하여 보기 로 한다. 

//먼저 부호화기의 대면을 생성 
StringEncoder encoder 

=StringEncoder. getEncoder(StringEncoder. Encoding. NATIVE2ASCII) ； 

// encode 메쏘드에 부호화대상문자렬을 넘기면 
//부호화된 문자렬이 출력된다. 

String result=encoder.encoder.encode ( “통일조국 one!” ); 

System, out. println(result); 

출력결과는 다음과 같다. 

/ udlb5 / uc77c/uc870/uad6done! 


7.3.2. 문제점의 도출 

얼핏 보기에는 이 부호화기에 별로 문제가 없다고 생각된다. 이 부호화기는 물론 정 
확히 동작하며 요구사항을 만족시킨다. 또한 설계의 일반성을 만족시키고 있다고 볼수 
있 다. 메쏘드 (getEncoder) 작성 으로 실현클라스 (implementation class) 의 이름을 모르 
고서도 부호화기의 대면을 생성할수 있으며 새로운 부호화기방식을 제공할 필요가 있을 
때 에도 실현클라스의 추가요구에 대 응할수 있다. 여기 에 몇 가지 불합리한 점 이 있는데 
그 하나는 StringEncoder 클라스이다. 이 클라스에는 부호화기가 실현할수 있는 API 의 
정의 (encode 메쏘드)와 부호화기의 실현클라스를 적절하게 대면화하는 제작소 (factory) 
의 기능을 실현하는 getEncoder 메쏘드가 들어 있다. 이 정의로 하여 StringEncoder 
의 실현클라스는 본래의 부호화기로서의 거동외에 제작소로서의 역 할도 계승한다. 즉 
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StringEncoder encoder 

=Native2AsciiEncoder. getEncoder(StringEncoder. Encoding. ROT13) ； 
다음으로 부호화기의 원천코드를 본다(그림 7-2). 


Public String encode (String str ) { 


Public String encode (String str ) { 

Try { 


Try { 

/ _ /i. 읽기 준비 

— 

동 

일 

함 

7/1 .읽기 준비 

StringReader in = 

StringReader in = 

new StringReader ( str ) : 

new StringReader ( str ) ； 

StringWriter out = 

StringWriter out = 

new StringWriter () ； 


new StringWriter () ； 




//2 . 부호화기 처 리 


//2. 부호화기처 리 

for(int c =0; ( c = in . readO ) 卜- 1;) { 


for(int c =0; ( c = in . readO ) 卜- 1;) { 

if (31 〈c && c < 127) { 


if (( ‘ a ’ <=c && c <= ‘ m ’ ) 

out . write ( c ); 

여 

I | ( ‘ A ， <-c && c 

} else { 

기 

<= ‘ M ’ )){ c +=13; 

String hex = 

가 

}else if (( ‘ n ’ <=c && c <= ‘ z ’ ) 

integer . toHexString ( c ); 


||( ‘ N ， <=c &&c 

/ 八)을 4 자리로 한다. 

차 

<= ‘ Z ， )){ c -=13; 

While ( hex . length 0 <4) { 

이 

} 

hex = “ 0 ” + hex ); 

난 

out . write ( c ); 

} 

다 

U L _ 

out . write ( “\\ u ” + hex ); 

} 

} 

/ 

/ 

✓ 

/ 

/ 

/ 

/ 

✓ 

/ 





//3 . 후처 리 


//3 . 후처 리 

try { 


try { 

in.closeO ； 

여 

in.closeO ； 

} finally { 

} finally { 

out . closeO ; 

기 

out.closeO ； 

} 

r: 

} 

return out . getBufferO . toStringO ; 

같 

return out . getBufferO . toStringO ； 

} catch (IOException ice ) { 

다 

} catch (IOException ice ) { 

return str ； 

} 


return str ； 

} 


그림 7-2. 부호화기의 원천쿄드를 대비 
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2개의 부호화기원천코드는 부호화알고리듬을 서술한 부분외에는 꼭 같다. 아마 이 
런 클라스의 작성 자는 제 일 처 음 어 느 한 클라스를 쓰고 복사 ( copy ) 나 붙이 기 ( paste ) 
로 다른 하나를 만들것 이 다. 

여기에 다음과 같은 문제점이 있다. 

• StringEncoder 가 API 의 정의，실현클라스의 실례화라는 두가지 서로 다른 역 
할을 한다. 

• 부호화기의 실현클라스에 중복되는 코드가 많다. 

이것을 다음과 같이 개편하기로 한다. 

• 부호화기 의 골격 인 AbstractStringEncoder 를 작성 하고 매 부호화기 의 공통부 
분을 정의 

• 실현클라스의 실례화를 담당하기 위 한 StringEncoderFactory 를 작성 

• 부호화기가 실현할수 있는 API 를 정의하는 대면 StringEncoder 를 작성 
개편한 다음의 클라스도는 그림 7-3 과 같다. 


o- 

StringEncoder 


부호화기 외 API 를 정 의 한다 ^ 


AbstractStringEncoder [ ^ 


부호화기 의 골격실현 
각 부분블라스被의 공통처 리 
를 실현한다 


Native 玄 AsciiEncoder 


Encoder | ROTISEncodgr | 


골격실현을 기본으로 
부호화처려를진행 


부호화기의 개체례를 
생성하는 역할을 한다 


StringEncoderFactory 


+ getEncoder ( encodtng : Encoding ); Strin9Encoder 


그림 7-3. 개편한 다음의 클라스 

어 떤 복잡한 개 편조작에 대 하여서 도 그것 을 진행 한 즉시 에 [ Refactoring ] ᅳ 
[ Restore ] ( alt + shift + z ) 로 조작을 취소시 킬수 있다. 
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7.3.3. encode 메쏘드를 형판화 

Native 2 AsciiEncoder 의 Encode 메쏘드에 대해서 보기로 한다. 이 메쏘드는 준비， 
부호화처 리，후처리 의 3단계 를 거 친 다. 

여기서 부호화처 리만은 이 클라스만이 가지는 처 리이며 준비와 후처리는 다른 부호 
화기 에서도 공통적 인 처 리 이 다. 그리 고 이 메쏘드에서 init (준비)， doEncode (부호화처 
리)， dispose (후처 리)의 3개 메쏘드를 추출하고 encode 메쏘드는 그것들을 순서대로 호 
출하기 만 하는 형 판메쏘드로 한다. 이 때 공통처 리 부분을 상위클라스에 작성해놓음으로써 
중복코드를 쉽게 없앨수 있다. 매 부호화기자체의 처리는 encodeO 가 호출하는 
doEncodeO 를 덧쓰기 ( overwrite ) 하여 실현한다. 

그러 면 먼저 준비 단계 로서 처 리 부분을 선택하여 [ Refactoring ] ᅳ [Extract 
Methods ] ( Alt + shift + M ) 을 실행 한다(그림 7-4). 



그림 7-4. 추출범우ᅵ를 선택 


f™ Extract Method 



Ambiguous return value: selected block contains more than one assignment to local variable. 




그림 7-5. 메쏘드추출의 실패 

실패하면 그림 7-5 와 같은 통보창이 나타난다. Java 메쏘드에서는 값을 하나밖에 되 
돌려줄수 없기때문에 국부변수에로의 대입이 2개이상 있는 경우 메쏘드를 추출할수 없 
다. 이러한 경우 다음과 같은 2가지 대책이 있다. 

• 추출범위를 조절하여 국부변수에로의 대 입을 한곳에서 진행한다. 

• 국부변수를 마당으로 변환한다. 

여기서는 두번째 방법을 리용한다. 국부변수 in 을 찰칵하여 반전상태로 놓고 
[ Refactoring ] — [Convert Local Variable to Field ] ( Alt + shift + F ) 을 실행 하면 그림 
7-6 과 같은 대화칸이 현시된다. 
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Field 


Access modifier 

O 뼤 O protected 

fnitialize \n 
O Field declaration 
® Current method 
O Qa55 constructor!、} 


□ EJeclare field as 'static 4 


O default 



Mm 


Preview > 


OK 


Cancel 


그림 7-6. 국부변수를 마당으로 변환 


접 근수식 자나 초기 화의 지정 은 기정 값으로 설정 하고 [ Preview ] 단추를 찰칵한다(그 
림 7-7). 
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그림 7-7. 미리보기대화칸 
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여기서 원천코드가 어떻게 변경되였는가를 실행전에 확인할수 있다. 마당이 추가된것 
을 확인한 다음 [ OK ] 단추를 찰칵한다. 마찬가지로 out 도 마당으로 변환한다(그림 7-8). 



그림 7-8. 마당의 작성 

이제는 앞에서 실패했던 [메쏘드의 추출]조작을 다시 한번 시도해본다. 이번에는 정 
확히 [Extract Methods ] 대화칸이 현시된다(그림 7-9). 

메쏘드이름을 《 init 》 로 한다. [ Preview ] 단추를 찰칵하여 확인한다(그림 7-10). 



그림 7-9. 메쏘드의 추출 

[ OK ] 단추를 찰칵하면 메 쏘드가 추출된 다. 
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그림 7-10. 메쏘드의 추출 미리보기 


다음으로 부호화처리부분도 다른 메쏘드에로 추출된다(그림 7-11). 


25 

26 
27 
28 ^ 

29 

30 

31 _ 

32 _ 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 


* @param str 

* ©return 
*/ 

public String encode(String str) { 
try { 

init(str); 


for (int c = 0; (c = in.readO) != -1;) { 
if (31 < c && c < 127) { 
out.write(c); 

> else { 

String hex = Integer.toHexString(c); 


while (hex.length() < 4) { 
hex = "0" + hex; 

> 

out.write("\\u M + hex); 


try { 

in.close(); 
> finally { 


- 四: 


:因 


그림 7-11. 부호화처리를 추출 
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이 로부터 추출하는 메 쏘드는 매 부호화기 ( stringEncoder 의 보조하위 클라스) 가 자 
체의 부호화처리를 실현할수 있도륵 재정의되여야 한다. 이와 같은 메쏘드를〈〈갈구리메 
쏘드》라고 부르며 doXXX 라는 이 름을 가지 는 경 우가 많다. ( HttpServlet 의 doGet , 
doPost 등은 그의 전형적인 실례이다.) 여기서는 관습에 따라 이 메쏘드에 
《 doEncode 》 라는 이름을 붙인다(그림 7-12). 


ᅡ Extract Method 


Method name: doEncode] 


Access modifier: ('public ■ J protected ■ [ ■ default ■ 寒 , private 


□ Add thrown runtime exceptions to method signature 
0 Generate Javadoc comment 

□ ■ 

Method signature preview: 

private void doEncode () throws lOException 



PrevSew > 


OK 


Cancel 


그림 7-12. doEncode 의 추출 

마지막으로 후처리부분은 《 dispose 》 라는 메쏘드에로 추출된다. 
결과적 으로 encode 메 쏘드는 다음과 같다. 


* Native 2 Ascii 방식으로 문자렬을 부호화한다. 
* 

*9 param str 부호화대상문자렬 
*Sreturn 부호화결과 
*/ 

public String encode (String str ) { 
try { 

init ( str ); 
doEncode 0; 
dispose 0; 

return out . getBufferO . toStringO ； 

}catch (IOException ioe ) { 
return str ； 
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이 시점에서 Native 2 Ascii 부호화기는 그림 7_13과 같다. 



a in : String Reader 
° out : String Writer 
■:' L Native2AsciiEncoderO 


O^encodeCString) 
0 disposeO 
a doEncodeQ 
m init(String) 


그림 7-13. Native 2 Ascii 부호화기 


여기서 메쏘드의 추출이 완료되였다. 그러나 ROT 13 Encoder 와의 중복코드는 아직 
해결하지 못했다. 

7.3.4. encode 메쏘드의 끌어올리기 

이제 중복코드의 처리를 진행한다. 순서는 다음과 같다. 

① Native 2 AsciiEncoder 의 encode 메쏘드 등 모든 공통처리부분을 상위클라스에 
끌어올린다. 이때 doEncode 메쏘드는 상위클라스에서는 abstract 로 선언하고 하 
위클라스에서는 덧쓰기하면 된다. 

② ROT 13 Encoder 의 doEncode 메쏘드를 실현한다. 

7.3.5. 끌어올리려는 성원의 선택 

그러 면 먼저 Native 2 AsciiEncoder 의 encode 메 쏘드를 선택 하여 [ Refactoring ] — 
[Pull up ] 을 실행한다(그림 7-14). 
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그림 7-14. 끌어올리기 

골어올리려는 성원으로서 encode ( String ) 가 선택되여있지만 여기서 [Add Required ] 
단추를 찰칵하면 함께 끌어올릴 필요가 있는 성 원들을 Eclipse 가 검 색하여 선택 해 준다. 
여기서는 모든 마당，메쏘드가 끌어올리기대상으로 되였다. 

7.3.6. doEncode 를 추상메쏘드로 선언 

그러나 doEncode 는 Native 2 AsciiEncoder 자체의 알고리듬을 서술한 메쏘드이므 
로 그대로 상위클라스에 끌어올릴 필요는 없다. 

[ action ] 칸을 찰칵하여 [Declare abstract in destination ] 을 선택 한다. 이 렇게 하 
면 doEncode 메쏘드는 StringEncoder 클라스에서 추상메쏘드로 선언되여 하위클라스에 
서 덧쓰기할수 있게 된다(그림 7-15). 
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그림 7-15. 끌어올리려는 메쏘드 

doEncode 메 쏘드가 아직 존재 하지 않는 ROT13Encoder (부호화기 실현들라스) 에 는 
형 태만 자동적 으로 정의된다. [Next] 단추를 찰칵하여 필요없는 메 쏘드의 제거 작업 에 들 
어간다. 

7.3.7. 필요없는 메쏘드의 제거 

Native2AsciiEncoder 클라스로부터 다음의 성 원이 상위클라스에 끌어 올려전다. 

• 마당 in, out 

• 메쏘드 encode, init, dispose 

이것들은 부호화기의 종류에는 관계 없는 공통적 인 처 리이므로 하위클라스에는 필요 
가 없다. 또한 상위클라스에 있는 StringEncoder 에는 추상메쏘드 encode 가 남아있지 
만 이것도 Native2AsciiEncoder 로부터 끌어 올린 encode 메쏘드에 의하여 치환되므로 
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필요없다. 

이 대화칸에서 끌어올리기에 의하여 불필요하게 되는 메쏘드들을 선택하여 놓으면 
Eclipse 가 자동적 으로 삭제한다(그림 7-16). 


|늑 Refactoring 


因田 

Pull up 

① Select the methods to be removed in subtypes after pull up. 

4 method(s) selected. 


的 

Subtypes of type 'sample.StringEncoder' 

Source 



7 H © A StringEncoder 

▽ 0 © Native2AsciiEncoder 

0 ■ disposeO 
0 參 encode(String) 

0 ■ init(String) 

▽ □(3 ROT13Encoder 

□ • encode(String) 


A encode(String) 


/** 


* @param argO 

貪 

* ©return 

public abstract String encode(String argO); 


JB 


Restore Defaults 


< Back 

凶 BXt > 

Rnish 

Cancel 


그림 7-16. 불필요한 메쏘드의 제거 


7.3.8. 미리보기 및 실행 


[ Next ] 단추를 찰칵하여 StringEncoder 클라스에 마당이나 메쏘드가 이동되였는가， 
doEncode 메쏘드가 정확히 추상메쏘드로 선언되였는가를 확인한다(그림 7-17). 또한 
작성한 단계 에서 private 된 마당이 나 메 쏘드 init 가 protected 로 변경 되 였 다는것 을 알 
수 있는데 이것은 하위클라스로부터 호출되도록 자동적으로 필요한 변경이 진행되였기때 
문이 다. 
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그림 7-17. 끌어올리기의 미리보기 

[ Finish ] 단추를 찰칵하면 개편이 완성된다. 

7.3.9. 나머지부분의 처리 

ROT 13 Encoder 에는 메쏘드추출을 진행하기 전의 encode 메쏘드가 남아있다. 이 
encode 메 쏘드로부터 부호화처 리 부분만을 doEncode 메 쏘드로 뽑아내 야 한다. 
doEncode 메쏘드의 형판이 자동적으로 작성되여있으므로 이것을 리용하여 메쏘드의 추 
출을 쉽게 진행할수 있다(그림 7-18). 
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JTj Native2A5ciiEnco... 


2 〔广 

21 

22 

23 

24 

25 

卜 ▽ 

27 

28 

29 

30 

31 

32 " 

33 

34 

35 

36 

37 
33 

39 

40 

41 
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43 

44 

45 
J46 
■47 

48 

49 

50 

51 

52 

53 
_54 

55^ 

56 

57 
58^ 

59 

60 } 
61 




0 EncoderMain.java 


El 니 jj StringEncoderJava 




* R0T13 

* 

* ^param Etr 

* ©return 

V 

public String encode(String str) { 
try { 

StringReader In = new StringReader(str); 
StringWriter out = new StringWriter(); 


for (int c = 0; £c = in .read()) != -1;) { 

if (C ， a ， <= c M c <= -in p ) | | C ， A ， <= c M c <= ， M，)) { 
c += 13; 

} else if {{^n* <= c Mi c <= _z') | | ( 내 1 <= c M c <= 1 
c -= 13; 


out.writeCc); 


try { 

In. closeO ; 

> finally { 

out.close( ) ; 


Tetum out. getBuffer () ■ toString ( ) ; 
> catch (IOException ioe) { 

retuna str : 


/* tnon - Javadoc ) 

* 逆 see sample .StringEncoder#doEncode() 


protected void doEncode() throws IOException { 

> _ 



□ 


V 


因: 


그림 7-18. ROT 13 Encoder 의 doEncode 메쏘드를 실현 

doEncode 메쏘드가 완성되면 이미 있던 encode 메쏘드의 잔상을 잊지 말고 제거한 
다. 이상으로 중복코드가 완전히 없어진다. 

다음단계 로 들어 가기 전에 한번 시험 을 진행해 본다. [ SampleChap 기프로젝트를 선 
택하여 [ Run ] ᅳ [Run As ] ᅳ [JUnit Test ] 을 실행한다(그림 7-19). 
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그림 7-19. 푸른색띠가 나타나는 실행대화칸 

7.3.10. 구체례생성론리의 분리 

이제 다음과 같은 두가지 문제가 남아있다. 

• StringEncoder 로부터 부호화기의 구체례생성론리를 갈라 낸다. 

• 부호화기의 API 정의를 대면으로서 추출한다. 
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먼저 구체례생성론리의 갈라내기를 진행한다. 순서는 다음과 같다. 

① StringEncoder . Encoding 을 상위 클라스로 변환 

② StringEn ⑴ derFactory 클라스의 새로 작성 

③ getEncoder 메 쏘드를 StringEncoder 에서 StringEncoderFactory 로 이동 

먼저 StringEncoder . Encoding 을 선택 하여 [ Refactoring ] — [Move Member T 
ype to New File ] 을 실 행한다 (그림 7-20). 

[ OK ] 단추를 찰칵한 다음 차림 표에서 [ File ] —[ New ] —[ Class ] 를 선택 하면 새 로운 클라 
스창조대화칸이 나타난다. 여기서 StringEncoderFactory 클라스를 작성한다(그림 7-21). 



그림 7-21. StringEncoderFact 아 y 의 작성 

다음으로 StringEncoder 클라스의 getEncode 메 쏘드를 StringEncoderFactory 로 
이동한다. getEncoder 메쏘드를 선택하고 차림표띠에서 [ Refactoring ] —[ Move ] 을 
실 행한다(그림 7-22). 


Destination type for 'getEnc oder(E ncodin§)': 


]n|xj 




Browse... 


Cancel 



그림 7-22. 성원의 이동 
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[ Browse ] 단추를 찰칵하여 현시 되 는 [Choose Type ] 대 화칸에 서 메 쏘드가 이 동되 여 
갈 클라스를 선택한다(그림 7-23). 



그림 7-23. [Choose Type ] 대화칸 

[ OK ] 단추를 찰칵하면 [Move Static Members ] 대 화칸이 현시되는데 여 기서 
[ Preview ] 를 찰칵하여 확인한다. 그렇게 하면 그림 7-24 와 같은 경고가 나타날수도 
있지 만 이 에 상관없 이 [ Continue ] 를 찰칵하면 미 리보기화면 이 현시 된다(그림 7-25). 
StringEncoder . getEncoder 를 호출한 부분이 시험 클라스까지 포함하여 모든 
StringEncoderFactory 의 호출로 바꾸어 진 다. 참조를 모두 검 색 하여 남김 없 이 갱 신 
한다고 하는것이 바로 개편도구의 위력이 있다. [ OK ] 단추를 찰칵하면 메쏘드의 이동 
이 완료된다. 
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그림 7-24. 경고화면 


Static Members 


Changes to be performed 



> 0^StringEncoderTest.java - SampleChap7/test/sample 


> 0^ StringEncoder.java • SampleChap7/src/sample 


> H^StringEncoderFactory.java - SampleChap7/src/sample 




o 舍 | 


Sl EncoderMain.java 


必 分 


Original Source 


Refactored Source 


if (args.length > 公 && args[0].equals 
encoding = Encoding.R0T13; 

} 


StringEncoder 


BufferedReader br = new BufferedReade - 

for (String line; (line = br.readLine 
System.out.printIn(encoder.encode 

> 


if (args.length > 0 && args[0].eqt 
encoding = Encoding.R0T13; 

} 


StringEncoder 


BufferedReader br = new BufferedR< 

for (String line; (line = br.read] 
System.out.println(encoder.em 

> 



그림 7-25. 메쏘드이동의 미리보기 
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7.3.11 대면의 추출 

마지막으로 남은 문제는 StringEncoder 클라스로부터 부호화기의 API 정의를 갈라 
내는 문제 이다. StringEncoder 클라스는 어디까지나 부호화기의 골격을 실현하지 외부 
API 를 정의하는것을 목적 으로 하지는 않는다. 그래서 이것 을 AbstractStringEncoder 
와 골격 에 어 울리 는 이 름으로 변경하여 새 롭게 StringEncoder 대 면을 정 의한다. 

무엇 보다 먼저 이 름변경 을 진행한다. StringEncoder 를 선택한 다음 차림 표띠 로부 
터 [ Refactoring ] —[ Rename ] 을 실 행 한다 (그림 7-26). 



그림 7-26. 클라스의 이■변경 


이때 public 클라스의 이 름변경 으로 원천코드안의 참조갱 신뿐아니 라 파일 이 름의 변 
경도 진행해 야 하는데 이것을 모두 Eclipse 가 한다(그림 7-27). 이 렇게 하여 
StringEncoder 는 골격에 어울리는 이름으로 변경되였다. 

다음으로 이 추상클라스에서 부호화기의 API 만을 골라낸다. AbstractStringEnc 
oder 를 선택 한 다음 차림 표띠 로부터 [ Refactoring ] —[Extract Interface ] 을 실행 한 
다. 대면이름을《 StringEncoder 》 으로 입 력 하고 대면안에서 선언되는 성 원을 선택 하 
여 둔다. 또한 [Change references to the class ‘ AbstractStringEncoder ’ int 
o references to the interface (where possible )] 을 선택하면 AbstractStringE 
ncoder 에로의 참조가 새롭게 선언되는 대면 StringEncoder 를 참조하도록 변경된다 
(그림 7-28). 
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그림 7-27. 클라스이■변경의 미리보기 


^ ~^ 대 X ] 

interface name: String Encoder 

0 Change references to the dass 'AbstractStrirtgEncodef into references to the interface (where possible) 

0 Declare interface methods as 'public' 

0 Declare interface methods as ^abstract" 


Members to declare in the interface: 


E3 ᅩ encodeCString^ 

SeJett All 


OeseJect Ail 


Preview > 


OK 


Cancel 


그림 7-28. 대면의 추출 

[ Preview ] 단추를 찰칵하면 또 경 고가 나타나지 만 이 에 상관없 이 [ Continue ] 를 찰 
칵한다(그림 7-29). 
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그림 7-29. 대면추출의 미리보기 

그림에서 보는바와 같이 AbstractStringEncoder 형의 변수가 모두 StringEncod 
er 형 으로 변경 되 였 다. 다음 [ OK ] 단추를 찰칵한다. 이 것 으로서 API 정 의 (StringEncod 
er ) ，부호화기 의 대 면 실 현 ( StringEncoderFactory ) ，부호화기 의 골격 (Abstractstring 
Encoder ) 이 완성 되 였 다. 

그러면 마지막으로 한번 더 시험을 진행하여 개편을 끝낸다(그림 7-30). 
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제4절. 기타 개편조작 

지금까지 다음과 같은 개편조작에 대 하여 소개 하였다. 

• 이름변경 

• 이동 

• 메 쏘드의 추출 

• 끌어올리기 

• 국부변수를 마당으로 변환 

• 대면의 추출 

• 겹싼형의 상위형에로 변환 

이외에도 몇가지 사용빈도가 높은 조작방법이 있는데 여기서 종합적으로 설명하기 
로 한다. 

7.4.1. 제작소 ( factory ) 의 도입 

구성자를 public 로 선언하면 그의 클라스의 보수와 확장이 가능하다. 실례 로 여 러 
사람들이 오래동안 사용하고있는 틀거리 ( framework ) 의 보수를 진행한다고 생각해보자. 

먼저 어 떤 클라스에 public 구성 자를 정 의 한다. 들거 리 의 사용자는 이 구성 자를 사 
용하여 구체 례 를 생 성 하는 코드를 작성 하게 된다. 그런데 마침 내 그는《 이 클라스는 하 
나로 할수 있었다. 구체례를 대량생산할 필요는 없다.〉)는것을 알게 될것이다. 새로 단일 
구체 례 를 되 돌려 주는 제 작소메 쏘드를 정 의할수는 있지 만 public 구성 자를 사용하고있는 
사용자가 대부분인 이 상 이제 와서 구성자를 private 로 바물수는 없다. 그리 하여 《제 일 
처 음부터 제 작소메 쏘드를 정 의하여 놓았으면 좋았겠는데》하고 후회하게 된 다. 

《 제작소의 도입》은 이러한 폐단을 미연에 방지하기 위하여 public 구성자를 
private 로 변환하여 구체 례 생 성 용의 제 작소메 쏘드를 정 의 하는 개 편방법 이 다. 

여기서는 실례로서 Native 2 AsciiEncoder 클라스의 구성자에서 제작소메쏘드를 생 
성 하기 로 한다. 패 키지 열 람기 에서 Native 2 AsciiEncoder 클라스의 구성 자를 선택 하고 
[ Refactoring ] ^ [Interface Factory ] 을 실 행 한다. 그러 면 [Interface Factory ] 대 화칸 
이 현시된다(그림 7-31). 




그림 7-31. 제작소에 관한 설정대화칸 
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또한 제작소메 쏘드를 Native2AsciiEncoder 클라스가 아니 라 다른 클라스로 만들수 
도 있다. 이 실례 에서는 기정 으로 설정한다. [Preview] 를 찰칵하면 그림 7_32 와 같은 
대화칸이 현시된다. 



OK 


Cancel 


그림 7-32. 제작소도입의 미리보기대화칸 

구성 자가 private 로 되 고 제 작소메쏘드가 생성되며 구성 자를 호출하는 다른 클라스 
도 제작소메쏘드를 사용하도록 변경된다. 

7.4.2. 상수의 추출 

이것은 기계어코드로 된 수값이나 문자렬을 static final 의 마당으로 선언하고 그의 
참조로 치환하는 조작이다. 의미가 명확치 않은 수자는 이 개편을 적용하여 리해하기 쉬 
운 상수로 치환하기도 한다. 

여기서는 실례로서 앞의 ROT13Encoder 클라스의 doEncode 메쏘드에 있는 《 13 》 
이 라는 수자를 상수로 치환한다(그림 7-33). 
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□ 

36 

in.closef) : 




37 

} finally { 




38 

out.closef) : 




39 

} 




40 





41 

return out.getBufferC).toStringC); 



42 

> catch (TOException ioe) { 




43 

return str : 




44 

} 




45 

} 




|46^ 

/* (non-Javadoc) 




47 

* 色 see sample.StringEncoderMoEncodeC) 



4S 

*/ 




틀 49 ▽ 

protected void doEncodef) throws IOException { 



■ 50 

for (int c = 0; (c = in.read()) 

!= -1；K 



■ 51 

if (( ， a ， <=c M c<='m , ) || 

( ， A，<=c <M t:<= ， M，)){ 



■ 52 

c += [0; 




■ 53 

} else if ( 「 rr<=c && c<= ■ 

， z.)|| ( ， N ， <=c M c <= 



|54 

c 13; 




■ 55 

> 




… 56 





_57 

out.write(c); 




■ 58 

> 




§59 





■60 

> 




61 > 





62 





LiL 



1IH 


그림 7-33. 수자《13》의 추출 

《13》을 두번 찰칵하여 선택 하고 [ Refactoring ] —[Extract Constant ] 을 실행 한 
다(그림 7-34). [constant name ] 에 《 SHIFT _ WIDTH 》 를 입 력 한다. [Replace all 
occurrences of the selected expression with references to the constant ] 검사 
칸을 선택 하고 [ Preview ] 단추를 찰칵한다(그림 7-35). 



Constant name: SHIFT.WIDTH 


Access modifier. ◦ public ◦ protected Q default 受 ) private 


0 ^Replace all occurrences of the selected expression with references to the constant 


□ Qualify constant references with class name 


Signature Preview: private static final int SHIFT_WIDTH 


■石 ra 


Preview > 


OK 


Cancel 


그림 7-34. 추출대화칸 
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4 불게방환경 Eclipse 


Changes 


to be performed 


ROT13Encoder.java • SampleChap7/src/sample 


7 0© ROT13Encod€r 

Declare constant 
7 0 公 doEncodeO 

Replace expression with a constant reference 
Replace expression with a constant reference 


必 分 I 


因 ROT13Encoder.java 


必 分 


Original Source 




; R0T13Encoder extends AbstractStringEn 


public R0T13Encoder() 
super(); 


r @param s. 
r Oreturn 


public String encode(String str) { 
try { 


StringReader in = new StringReader(str 
StringWriter out = new StringWriter(); 


in.close(); 


Refactored S 


public R0T13Encoder() 
super(); 


r @param s* 
r Oreturn 


public String encode(String str) 
try { 


StringReader in = new StringReader i 
StringWriter out = new StringWrite: 


그림 7-35. 추출결과 

이 실례에서는 추출대상이 불과 2개 밖에 없었지만 이것이 몇백，몇천개 있어도 
Eclipse 는 하나도 빠짐 없 이 완벽하게 수정 을 진행한다. 역 시 같은 조작으로 국부변수의 
추출도 할수 있다. 


7.4.3. 제자리화 

상수의 추출，국부변수의 추출은 메쏘드의 추출과 같이〈〈추출계조작》이 라고 불리운다. 
여 기서 설명하는 제 자리 화 (in line ) 는 추출계 조작과 완전히 반대 의 동작을 진행한다. 
즉 메 쏘드호줄이 나 상수，국부변수의 참조를 제 거 하는 조작이 다. 

개편에 역행하는것과 같은 이 조작들이 과연 어떤 때에 필요하겠는가. 개편을 반복 
하여나가면 처 음에는 복잡한 메 쏘드가 간단하게 되며 종당에는 메 쏘드로 만들 여지 가 없 
는 단순한 코드로 되 는것 도 있 다. 그러한 경 우에 메 쏘드를 제 자리 화하는것 이 다. 상수나 
국부변수에 관하여도 같다. 여기저기서 참조된 변수가 종당에 한곳에서만 참조되게 될 
때 제자리화를 검토한다. 

여기서는 앞의 개편에서 제일 처음으로 메쏘드추출을 진행한 

AbstractStringEncoder 의 init 메 쏘드를 제 자리 화하여 본다. Outline 보기 에 서 init 메 쏘 


194 錢變繼錢變變繼繼繼 



































세 7 상. 개 4 


드를 선택 한 다음 차림 표띠 에서 [ Refactoring ] —[inline 화] ( Alt + Shift + L ) 을 실행 한다 
(그림 7-36). 



그림 7-36. 제자리화 설정대화칸 

init 메 쏘드를 호출하는 부분을 모두 치 환하겠는가 혹은 선택한 부분만을 치 환하겠는 
가를 여기서 설정한다. 이 실례에서는 메쏘드의 호출위치가 아니라 메쏘드선언 그자체를 
선택 하기 때 문에 [All invocations ] 칸을 선택 한다. [Delete Method Declaration ] 를 선 
택하면 원래 의 메 쏘드는 삭제 된다. [ Preview ] 단추를 찰칵한다(그림 7-37). 

圖^-- ■ 이 _ □! x [ 

Changes to be performed O D I ! 



그림 7-37. 메쏘드의 제자리화 미리보기 
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init 메쏘드가 정확히 제자리화되여 《메쏘드의 추출》을 진행하기 전의 상태로 된다. 
상수나 국부변수도 같은 방법으로 제자리화할수 있다. 

7.4.4. 마당의 은폐화 

《 마당은 private 로 선언하고 Getter / Se 竹 er 를 통하여 호출해 야 한다》는것 이 중요 
한 객체지향프로그람수법의 하나이다. 따라서 마당에 대한 조작을 직접 의뢰자에 맡기는 
것은 클라스의 은페화를 파괴하는것으로 된다. 

[Encapsulate Field ] 는 마당을 private 로 변경 하고 Getter / Setter 를 자동생 성하 
는 개편이다. 실례로 앞의 AbstractStringEncoder 의 《 in 》 마당을 은페시킨다. Outli 
ne 보기에서 마당 《 in 》 을 선택하고 [ Refactoring ] —[Encapsulate Field ] 를 실행한다 
(그림 7-38). 



그림 7-38. 마당의 은페화설정대화칸 


Getter , Setter ^ 이름， 접근식별자만이 아니라 
원천코드의 어느 위치에 들어있는가 하는 지정까지 
진행한다. [Field access in declaring class ] 에서 는 
마당이 선언되 여있는 클라스내 에서 그 마당을 호출할 
때 Getter / Setter 를 사용하겠는가 혹은 직접 호출하 
겠는가를 설정한다. 여기서는 대부분의 경우 직접호 
출을 선택한다. [ OK ] 단추를 찰칵하여 완료한다. 결과 
마당 《 in 》 이 private 로 되고 호출메쏘드가 생성되였 
다(그림 7-39). 


l a g 職 낯 O 샀 
® sample 

t> J ? import declarations 
▽ © A AbstractStri ngEnc oder 


■ m : StringReader 


今 out : String Writer 
效 ᅭ e nc ode(Stri ngj 

囚 disposeO 

必 A doEncodeQ 
分 sett n (String Reader) 
◊ get,nO 


그림 7-39. 마당의 은페화 
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제8장. Ant 지원 

제1절. Ant 란 무엇인가? 

Ant 란 ASF (Apache Software Foundation ) 의 Apache Ant Project 
(h 竹 p :// ant . apache . org ) 에서 개 발하고있는 쏘프트웨 어 개 발지 원도구이 다. 

주로 Java 개발자들을 위해 제작되였고 원천파일의 콤파일， API 문서의 생성， jar 파 
일작성 등의 작업을 지령조작으로 간단히 진행할수 있도륵 되여있다. 많은 량의 원천파 
일을 대상으로 일괄처리를 할수도 있고 간단한 정형처리를 자동화할수도 있는 등 통합개 
발환경 ( IDE ) 에서 하기 어 려운 작업을 이 도구를 리용하여 수행할수 있다. 

또한 Ant 는 그 자체 가 Java 로 서술되 였기때 문에 실행 기 반에 는 무관계 하게 동작한 
다는것도 이 도구의 특징중의 하나이다. 


제2절. 건립파일 

Ant 는 건립파일을 읽 어들여서 동작한다. 

건립 파일은 XML 형 식 으로 서 술되 여있는 일종의 스크립 트파일로서 Ant 가 리 해할수 
있는 명 령들을 조합시켜 여 러 가지의 처 리들을 서술한것 이 다. Ant 는 건립 파일을 해석 하 
고 실행시키는 해석기 라고도 말할수 있다. 

건립파일은 원천파일의 콤파일， JUnit 시험클라스의 실행， API 문서의 작성，콤파일 
된 클라스파일로부터 jar 파일의 생성과 같은 4가지 기능을 갖추고있다. 이 파일의 이름 
을 build.xml 이라고 달았는데 원래 Ant 의 기정건립파일이름이다. 


목록 8-1. build.xml 

<?xml version : “1.0” encoding : “ UTF -8” ?> 

〈project name = “ Refactoring ” basedir = default ^ “ build ” > 

〈 description 〉 건립，시험， API 문서의 작성， JAR 파일의 생성 등을 진행한다. 
〈/ description 〉 


<!— 속성 정의 一 〉 

< property name = “ dir . bin ” value = “ bin ” /> 
〈property name = “ dir . src . main ” value = “ src ” /> 

〈property name = “ dir . src . test ” value = “ test ” /> 
〈property name = “ dir . java . doc ” value = “ docs / api ” /> 
〈property name = “ file , jar ” value = “ classes , jar ” /> 
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<! 一 목표 정 의 一 〉 

< target name = “ build ” description ^ “원천파일을 번역한다. ” > 
<mkdir dir = “$ { dir . bin }” /> 

<javac desdir = “${ dir . bin }” debugs “ false ” > 

<src path = “${ dir . src . main } ” /> 

<src path == “${ dir . src . test } ” /> 

</ javac > 

</ target 〉 

<target name = “ test ” depends ^ “ build ” 

description ^ “시 험 을 진행한다. ” > 

<junit printsummary = “ yes ” > 

〈classpath location = “${ dir . bin }” /> 

< batchtest > 

<fileset dir = “${ dir . src . test } ” > 

〈include name = “**/* Test . java ” /> 
</ fileset > 

</ batchtest > 

</ junit > 

</ target 〉 

<target name = “ javadoc ” description ^ “API 문서를 작성한다. ” > 
<javadoc 

access = “ package ” 
destdir = “${ dir . javadoc } ” 
sourcepath = “$ { dir . src . main } ” 
packagenames = “ sample ” /> 

</ target 〉 


<target name = “ archive ” depends : “ test ” description ^ “ JAR 파일을 생성한다. ” > 
<jar jarfile : “$ { file , jar } ” > 

<fileset dir = “${ dir . bin }” > 

〈exclude name = “**/* Test . class ” /> 

</ fileset > 

</ jar > 

</ target 〉 

〈/ project 〉 
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제3절. 프로젝트，목표 

건립파일의 제일 바깥요소는 〈 project 〉 이다. name 속성에서 프로젝트의 이름을 지 
정한다. 실제 로는 간략기 능이 있지 만 이 름없 이 사용하는것은 불편하기때 문에 목록 8~1 
에서는 프로젝트의 이름을 Refactoring 이라고 달았다. 

프로젝트의 가운데 에 있는 〈 target 〉 요소에 의하여 목표를 정의한다. 

목표는 항상 이름으로 식별되기때문에 〈 project 〉 의 경우와는 달리 이것들의 속성은 
반드시 설정 해 주어 야 한다. Ant 를 기동시 킬 때 에 목표이 름을 지정하는것 으로서 수행 해 
야 할 동작을 실현할수 있다. 

실례 로 〈〈 build 》 라고 지 정하면 원천파일 이 콤파일되 고 class 파일 이 생성된다. 그리 
고 목표 이름을 특별히 지정 하지 않고 Ant 가 기동하는 경우엔 기정으로 정해진 목표가 
실행된다. 

기정목표는 〈 project 〉 요소의 default 속성으로 반드시 지정되여 야 한다. 

8.3.1. 목표의 의존관계 

목록 8-1 의 test 목표를 보면 JUnit 의 시 험클라스를 모두 추출하여 시험 을 진행하는 
것 이 목적 인데 그것을 실현하자면 프로그람이 반드시 를파일되 여있어 야 한다. 결국 test 
목표를 실행하기 전에 먼저 build 목표가 완료되여야 한다. 이것을 〈〈 test 는 build 에 의 
존하고있 다.》라고 한다. 

8.3.2. 과제 

이것은 등록부의 작성，원천파일의 콤파일， jar 파일의 작성에 리용한다. 

Windows 의 지 령 묶음파일 ( bat 파일) 이 나 Unix 의 쉘스크립 트에서 는 동작을 조작체 
계상에서 지령으로 실현하고있다. 그러나 Ant 에서는 이러한 기본동작의 하나하나가《과 
제》로서 정의되여있고 건립파일은 지령이 아닌 과제의 호출에 대하여 서술하고있다. 

목록 8-1 에서는 < mkdir >, < javac >, < jar 〉 라는 과제가 사용되고있다. 이처럼 지령 
호출을 과제 라는 형 식으로 추상화했으므로 Ant 의 건립파일은 실행 기 반에 의존하지 않는 
다. 목록 8-1 의 건립파일을 Windows XP 상에서 개발했지만 Unix 상에서도 득같이 동 
작시 킬 수 있 다. 조작체 계 에 의 존하는 지 령 을 실현하려 면 < exec 〉 과제 를 사용하면 된 다. 

8.3.3. 속성 

원천파일의 위치나 API 문서의 출력위치， JAR 파일의 이름 등 건립파일에서 자주 사 
용되 는 문자렬 을 속성 으로 정 의해 놓으면 편 리하다. 
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〈property name= “속성이 름” value= “속성 값” /> 

또한 파일 속성 을 리 용하여 java. util. Properties 형 식 의 속성파일 을 읽 어 들일수도 
있 다. 

〈property file= “파일이름” /> 

정의한 속성값을 참조할 때 에는 아래 와 같이 서술한다. 

${속성 이 름} 

〈 property 〉 요소는 다른 과제들과는 달리 〈 project 〉 요소의 바로 아래에 놓인다. 이 
렇게 건립파일전체에 대한 유효속성을 정의할수 있다. 

8.3.4. 조합속성 

Ant 는 표 8-1 에 서 술되 여있는 조합속성 을 제 공하고있다. 

이 것 들은 〈 property 〉 요소에 서 정 의하지 않아도 항상 참조할수 있 다. 


표 8-1. 

조합속성 


속성이 ■ 

설 명 


basedir 

기 초등록부이다. 건립 파일 전체 에 서 상대 경 로지 정 은 
등록부를 기준으로하여 진행된다. 

이 기초 

ant. file 

건립파일의 전체경 로이 름 


ant. project, name 

Ant 프로젝 트 이름 (Refactoring) 


ant. home 

Ant 의 설치등록부 


ant. version 

Ant 의 판본 (2004 년 7월 16일에 개발된 Ant 의 
1.6. 2이다. ) 

판본은 

ant. java, version 

Ant 실행에 사용된 JVM 의 판본 (1.6) 



8.3.5. 체계속성 

Java 의 체계속성도 Ant 의 속성과 같이 참조할수 있다. 
아래의 건립파일을 실행하면 

〈project default^ “getProperty” > 

< target name= “getProperty” > 

<echo message^ “${java, vendor} ” /> 
〈 /target 〉 

〈 /project 〉 

다음과 같이 출력된다. 

[echo] Sun Microsystems Inc. 
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8.3.6. 환경변수 

건립파일안에서는 환경변수도 참조할수 있다. 

〈 property 〉 요소의 environment 속성 에 서 환경 변수의 앞붙이 를 정 의 할수 있 다. 그 
것은 ${앞불이.환경변수이름}와 같은 형식으로 참조할수 있다. 

아래의 건립파일을 실행하면 

< project default^ “getenv” > 

〈property environment^ “env” /> 

<target name= “getenv” > 

〈echo message ᄄ “${env. SystemRoot} ” /> 

〈 /target 〉 

〈 /project 〉 

다음과 같이 출력된다. 

[echo] / root 

이 밖에 도 많은 기능이 있지 만 여 기서는 우에서 서 술한것 만 소개한다. 자세 한것을 알 
려면 다음의 거점을 참조하면 된다. 

http : / / ant, apache, org/manual/index, html 


Ant 오 } Make 

Ant 는 《Java 로 된 Make 와 같은 건설도구이다.》라고도 불리운다. 건립파일은 역 
할로 놓고보면 Makefile 과 비슷하고 목표라고 하는것도 Makefile 안에 득같이 정의 
되여있다. Make 를 알고있는 사람들은 《Ant 란 Java 로 된 Make 이다. Makefile 대 
신에 build.xml 이라는 XML 파일을 해석한다. 》 라고 하면 Ant 의 개요를 파악할수 
있을것이다. 

그러 나 Ant 에는 Make 와 다른점 이 있다. 

• Java 개 발자지 향이다. 

Make 는 주로 C/C++/Fortran 언어의 개발작업 용으로 리 용되지만 Ant 는 Java 개 
발작업을 기본으로 하고있다. 

• 건립파일을 XML 형식으로 서술한다. 

Makefile 은 자체의 문법을 가지고있고 Make 를 사용한 경우는 그에 따라서 필요 
하지 만 Ant 의 건 립파일 은 일 반적 인 Xml 파일 이기 때 문에 습득하기 가 쉽 고 일 반적 인 
XML 편집도구를 사용할수 있다. 

들여맞추기 (indent) 는 반드시 TAB 로 진행 하여 야 한다는 제 한도 없다. 
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제4절. 환경설정 

여기에서 실제로 Eclipse 의 Ant 지원기능을 시험해보기로 한다. 

7장에서 사용한 SampleChap 7 프로젝트에 있는 build , xml 을 리용한다. 

8.4.1. 환경변수 JAVA_HOME 

< javac > 나 < javadoc > 라는 과제 를 실 행 할 때 에 는 Ant 가 인 식 하는 클라스경 로에 
J 2 SDK 의 tools , jar 가 포함되 여있어 야 한다. 이 설정 은 후에 설명하는 [ Ant 실행 시 간 
설정] 에서 해 도 좋지 만 환경변수 JAVA _ HOME 으로 J 2 SDK ( java 쏘프트웨 어 개 발도 
구 : Java Software Development Kit ) 의 설 치 등록부를 지 정 해 놓으면 Eclipse 가 자동적 
으로 tools , jar 를 클라스경로에 추가해준다. JAVA _ HOME 은 Eclipse 뿐만아니라 그외 
여 러가지 개발도구가 참조하는 표준적 인 환경변수이다(그림 8-1). 

이 환경 변수를 설정 하기 위한 순서 는 다음과 같다. 

1. 탁상화면우의 [사용자등록부]를 두번 찰칵하여 파일열람기를 연다. 

2. [보기 ]차림 표의 [숨긴파일 표시 ]를 선택한다， 

3. bash _ profile 을 편집기로 열고 다음의 행을 추가해놓는다. 
JAVA _ HOME =/ usr / java / jdkl . 6. 0 

4. 체계를 재 가입한다. 

5. Eclipse 를 재기동한다. 
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8.4.2. 환경변수 Path 

Java 의 지령파일들이 들어있는 《 / usr / java / jdkl . 6. O / bin 》등록부를 환경변수 
PATH 에 설정해 놓는다. JAVA_HOME 의 설정 과 같이 하면 된다. 본래 의 PATH 설정행 
의 제일 마지막에 다음의 문자《: / usr / java / jdkl . 6. O / bin 〉〉 를 추가해놓는다(그림 8-2). 



그림 8-2. 환경변수의 설정 


제5절. Ant 의 간단한 실행 

Eclipse 에 서 Ant 를 실 행 하는 방법 은 여 러 가지 가 있지 만 가장 간단한 방법 은 패 키 
지열 람기 에 서 build , xml 을 오른쪽찰칵하여 현시 되 는 문맥차림 표로부터 [ R un ] ᅳ [1 
Ant Build ] 을 선택하는 방법이다. 이렇게 하면 선택된 건립파일의 기정목표가 즉시 실행된 
다. 표준출력 이 나 표준오유출력은 Console (조종탁)보기창에서 확인할수 있다(그림 8-3). 


Tasks 因 Console 效 ■ 效 | 韻 쇼 면 因 ° 

□ 

<terminated> SampleChap7 build.xml [Ant Build] /usr^java/jdkl.6.(Vbin/java (Jul 7, 2005 1:05:15 PM) 


Buildfile: /root/workspace/SampleChap7/build . xml 
build: 

BUILD SUCCESSFUL 

Total time: 3 seconds 

義 

1 시 l>l 



그림 8-3. Console 보기창에서 결과의 확인 
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제 6 절 . Ant 의 기동구성 

Eclipse 에는《기동구성》이라는 개념이 있다. 단순한 Java 응용프로그람， JUnit 시 
험클라스，끼워 넣기시험용의 실행시간작업대 등은 모두가 개개의 기동구성을 가지고있으 
며 실행할 때 필요한 여러가지 설정을 진행한다. 5 절에서는 없었지만 Ant 의 실행에도 
[기동구성]이 존재하고 Ant 실행의 고유설정을 할수 있다. 패키지열람기에서 build.xml 
을 오른쪽찰칵하고 [Run] —[ 2 Ant Build … ] 을 선택 하면 [Ant 기동구성]의 설정 대 화 
칸이 현시된다(그림 8-4). 



그림 8-4. [ Ant 기동구성]의 설정대화칸 

이 대화칸에서 실행목표의 선택，클라스경로나 속성 등 여러가지 설정을 진행할수 
있다. 이 설정들은 개개의 기동구성으로서 보관된다. 전체 건립파일의 공통설정은 차림 
표띠 로부터 [Window] - 수 [Preferences][Ant] [Runtime] (아래 에 서 는 《 Ant 실 행 시 
간설정》이라고 부른다.)에서 진행한다. 
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8.6.1. Main 태브 

[ Ant 기동구성]의 [ Main ] 태브에서 건립파일의 장소，지령행 인수 등 기본적 인 정보 
를 정 의한다(그림 8-5). 



그림 8-5. Ant 기동구성의 [ Main ] 태브 


[Build file (건립 파일)] 

건립파일의 위치이다. 이미 적당한 값으로 설정되여있기때문에 특별히 변경할 필요 
가 없다. 

[Base Directory (기준등록부)] 

건 립 파일 안에 서 상대 적 으로 지 정하여 야 할 경 로이 름들은 이 등록부를 기 준으로 하여 
정 해 진 다. 〈 project 〉 요소의 basedir 속성 의 지 정 도 의 미 적 으로는 같지 만 이 방법 이 우선 
시된 다. 

Ant 의 속성 $ { basedir } 로서 건 립파일안에 서 참조할수 있 다. 

[Arguments (인수)] 

Ant 에 넘겨지는 지령행인수이다. 

오른쪽의 [ Variables ] 단추를 찰칵하여 프로젝 트의 경 로이 름을 표시 하는 변수를 삽 
입할수 있다. 
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8.6.2. Refresh 태브 

Ant 의 실행에 있어서 작업공간상의 변화(파일의 작성，지우기 등)가 있는 경우에 
Eclipse 가 인식 하고있는 상태 와 실제 상태 사이 에 부정합이 발생한다. 구체 적 으로는 작성 
된 파일이 보기에 현시되지 않을수도 있고 제거된 파일이 보기에 남아있을수도 있다. 이 
것을 해소하기 위하여 수동으로 [ Refresh ] 를 실행 해도 좋지 만 여 기서 설정 해놓으면 
Eclipse 가 자동적 으로 진행한다(그림 8-6). 



그림 8-6. Ant 기동구성의 [ Refresh ] 태브 

• [Refresh resources upon completion (완료할 때의 자원의 갱신)] 

이것을 선택하면 Ant 의 실행 을 완료할 때 에 [ Refresh ] 가 실행된다. 그때 갱 신의 
적용범위를 표현하는 선택 단추들이 활성화된다. 기정은 [The entire workspace ] 로 되 
여 있지 만 작업 공간상에 많은 프로젝 트가 존재하는 경 우에 는 갱 신에 상당한 시 간이 걸 리 
게 된다. 그런 경우는 [The project containing the selected resource (선택된 자원 
을 포함한 프로젝트)]를 선택하여 범위를 좁히는것 이 좋다. 

• [Recursively include sub-folders (재귀 적으로 보조등록부까지 적용)] 

이것을 선택하면 [ Refresh ] 를 보조등록부까지 재귀 적 으로 적 용한다. 기정 으로서 

선택 되 여 있 다. 
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8.6.3. Target 태브 

[ Ant 기 동구성 ] 대 화칸에서 기 정 으로 선택 되 여있는 태 브이 다. 실 행하려 는 목표를 선 
택한다 (그림 8-7). 



그림 8-7. Ant 기동구성의 [ Target ] 태브 



Specify target execution order: 
(할 build (default target) 



Modify Attributes and lauinch. 




# archive 
#javadoc 



그림 8-8. 실행순서설정대화칸 


그림 8-9. Ant 기동구성의 [ Classpath ] 태브 
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• [Check targets to execute (실행목표선택)] 

실행하려는 목표를 선택한다. 목표는 여러개 선택가능하다. 

• [Target execution order (목표실행 순서 )] 

2 개이상의 목표를 선택한 경우는 [ Order ] 를 찰칵하여 실행순서를 변경시킬수 있다 
(그림 8-8). 


8.6.4. Classpath 래브 

Ant 실행 시 Java 프로젝 트안에서 의 건립경 로는 유효하지 않다. Ant 실행 용 클라스경 
로를 따로 정해주어야 한다. 전체 기동구성에서 유효로 하려는 경우에는 [Ant 실행시간 설 
정]에서 정의한다. [ Classpath ] 태브의 설정은 이 기동구성에서만 유효하다(그림 8-9). 

이 기 동구성 에 대 하여 클라스경 로를 정 의 한다. [Add JARs ] 단추로 작업 공간상의 프 
로젝 트안에 있는 jar 파일 을 추가할수 있 다. 또한 [Add External JARs ] 단추를 사용하 
면 파일체계상의 임의의 장소에 있는 jar 파일도 추가할수 있다. [ Up ], [ Down ] 의 단추 
로서 순서를 바물수 있다. 


8.6.5. Properties 태브 

건립파일에서 참조된 속성을 정의한다. 초기 
상태 에 서 는 [Use global properties as specified 
in the Ant runtime preferences (Ant 실행 시간 
설정에서 지정된 대역적속성을 사용)]이 선택되여 
있는데 이것은 [Ant 실행시간설정]에서 설정한 그 
대로이다. 선택를 없애면 이 기동구성의 고유속성 
을 정 의할수 있 다(그림 8-10). 

• [ Properties ] 

[Add property ] 단추로 속성 의 이 름과 값을 
추가할수 있다. 이것은 < property > 요소에서 
name 과 value 속성을 지정하여 정의하는것과 같 그림 8-10. Ant 기동구성의 [ Properties ] 태브 
다. [Edit property ] 단추로 이 미 존재 하는 속성 
을 편집할수 있 다. 

• [Property files ] 

java . util . Properties 형식의 속성 파일을 등록할수 있다. 이것은 〈 property 〉 요소에서 
file 속성을 정의 하는것과 같다. 

조선어 (전각문자)를 포함한 파일은 native 2 ascii 명 령으로 유니코드로 변환해둘 필요 
가 있다. 
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8.6.6. JRE 태브 

Ant 실행 시 에 사용하는 JRE 에 관한 설정 을 진행한다. 


보통 이 설정을 변화시킬 필요가 없지만 다른 
JRE 를 사용할 경 우에 는 [Separate JRE ] 를 선택하여 
다른 JRE 로 절환할수 있다. 

즉 선택가능한 JRE 는 [ Window ] —[ Preference ] 
— [ Java ] — [Installed JRES ] 에 등록된 JRE 들이 
다.(그림 8-11) 


8.6.7. Environment 태브 

앞에서 서술한 [ JRE ] 태브에서 [Separate JRE ] 를 
선택하여 Ant 실행에 적용된 환경변수를 설정할수 있다. 
[ New …]를 찰칵하면 새로운 환경변수를 추가할수 
있고 [ Select …] 를 찰칵하면 이 미 존재하는 환경 변수 
를 선택할수 있 다. [Environment variables to set ] 
란에 추가된 환경변수는 [ Edit … ] 를 찰칵하여 값을 재 
편집할수 있 다(그림 8-12). 





그림 8-11. Ant 구성의 [ JRE ] 태브 


Modify attributes and launch. 

Create a configuration that will run an Ant buildfile. 



Name: j SampleChap7 build.xml 


[jMain .’.Refresh | 이 。 Build 卜 소 Targets : Qasspath Properties i & ORE] P5 Environ 

mentj L Common 

An environment can only be used when running in a separate JRE. 

This setting can be configured on the JRE tab. 

Environment variables to set: 

Variable jvalue 

New... 

® 

o 

| Select... | 


1 - 1 



Apply 11 Revert 




그림 8-12. Ant 기동구성의 [ Environment ] 태브 
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8.6.8. Common 태브 

기동구성의 실행 및 보존에 대한 설정을 진행한다. 

• [Type of launch configuration (기동구성의 형래)] 

보통 [ Local ] 그대 로 하여 도 상관이 없다. [ Shared ] 를 선택하면 기동구성 을 XML 
형식으로 작업공간상에 출력할수 있게 된다. 이 설정은 림개발을 할 때 기동구성을 프로 
젝 트에 서 공유하는 경 우에 편 리하다. 

• [Display in favorites menu (애호차림표에 표시)] 

여 기서 [External tools ] 를 선택하면 작업 대의 [ Run ] ᅳ [External Tools ] 를 선택 
하여 현시되는 차림표에 이 기동구성이 추가되며 결과 간단히 실행할수 있게 된다. 

• [Launch in background (배경에서 기동)] 

이것을 선택하면(기정으로 선택되여있다.) Ant 실행이 배경방식으로 진행된다. 특별 
한 리유없이 변경할 필요는 없다(그림 8-13). 


SampleChap7 build. 


Modify attributes and launch. 

Create a configuration that will run an Ant buildfile. 




Name: SampleChap7 bu.ild.xml 


r^lMainj "Refresh| Build| ' 소 Targets | Classpath] Properties | sJRE ^Environment inCommoni 


Type of launch configuration: 
® Local 
O Shared 


Display in favorites menu: 
[례 External Tools 


0 Launch in background 



Apply 

Revert 


Run 

Close 


그림 8-13. Ant 기동구성의 [ Common ] 태호 
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제7절. [ Ant ] 보기창 

[ Ant ] 보기창은 여러개의 건립파일을 일괄적으로 관리하여 여러가지의 목표를 간단 
히 실행할수 있는 편리 한 창이다. 

차림표띠로부터 [ Window ] ᅳ [Show View ] ᅳ [ Ant ] 를 선택하면 [ Ant ] 보기창이 현 
시된다. 초기상태에서는 내용이 하나도 없는데 이것은 건립파일이 한개도 등록되여있지 
않았기때문이다(그림 8-14). 


OiftJine ■ :: 然 

ᄆ 因 

It 

엔 ■상 : 1 

| M ^ 

w 성하 


그림 8-14. [ Ant ] 보기 



그림 8-15. 건립파일의 선택화면 


여기에 건립파일을 등록한다. 그림 8-14 의 [Add 
Buildfiles ] 단추를 찰칵한다 (그림 8-15). 보기 창에 추 
가하려 는 건 립파일 을 선택한다. 그다음 [ OK ] 를 찰칵하 
면 [ Ant ] 보기창에 넣어진 건립파일(프로젝트)이 현시된 
다(그림 8-16). 이 상태에서 그림 8-16 의 [Run the 
Default Target ] 단추를 찰칵하면 이 프로젝트의 기정 목 
표인 build 가 실행된다. 또한〉단추를 찰칵하여 프로 
젝트를 전개하고 다른 목표를 실행할수도 있다. 실례로 
API 문서를 생성하는 javadoc 목표를 실행 해본다. [Run 
the Default Target ] 단추를 찰칵하면 [ Console ] 에 
Ant 로부터 출력된 문자렬내용이 현시된다(그림 8-17). 



그림 8-16. 건립파일을 추가한 
Ant ] 보기 
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그림 8-17. 실행결과 

정확히 실행되는가를 Web 열람기에서 확인해본다(그림 8-18). 



그림 8-18. 생성된 API 문서 
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제8절. Ant 편집기 

지 금까지 Ant 의 실행과 기동구성의 상세 한 설정 을 하였는데 이제부터는 건립파일에 
대한 편집을 해보기로 한다. 

Eclipse 에 는 《 Ant 편집 기》라고 하는 건립파일 작성 용편집 기 가 갖추어 져 있 다. 
build , xml 을 찰칵하여 Ant 편집기에 이 파일을 연다(그림 8-19). 


과 build 」 



그림 8-19. Ant 편집기에서 build . xml 을 열었을 때 

요소나 속성，지 령 등이 밝은 색 으로 표시 됨 으로 보기 가 쉽다. 

그림 8_19의 build.xml 에 목표를 한개 추가해본다. 

build 나 javadoc , archive 목표들의 실행과정에 생성된 파일을 모두 지워서 프로 
젝트를 깨끗한 상태로 만드는 《 clean 》 목표를 하나 만들기로 한다. 편집기의 유표를 
archive 목표의 마지 막까지 가지 고가서 새 로운 목표를 정 의한다. 내 용편집 조력기 능을 사 
용하여 최대한 빨리 해본다. 《<七 81 '》까_지 입력하고 Ctrl+Space 건을 누르면 〈 target 〉 가 
나타나며 그에 따르는 설명도 표시된다. [ Enter ] 건을 누르면 마지막 태그까지 일식으로 입 
력되고 속성의 입력을 하기 위하여 시작태그와 마지막태그의 가운데로 유표가 이동한다. 

[public tartget ] 를 선택 한다(그림 8-20). 
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그림 8-20. 내용물방조 

이것으로 쉽게 target 태그의 골격 이 완성 되였다. 

유표는 자동적으로 설명표식란의 [ target :] 행의 마지막으로 이동한다(그림 8-21). 
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그림 8-21. 내용편집조력기능을 리용한 결과 


錢變邊 錢變變繼繼繼 















































세 8 강. Ant 시원 


depends 속성도 자동적으로 생성되였지만 이 목표에서는 불필요한 속성이므로 제거 
한다. descriptions 속성 에 는《건립 에 의 해 생성된 등록부를 제 거 한다.》라는 설명 문을 써 
놓는다. 이것으로 목표의 틀거 리 가 완성되였다. 

다음은 실제의 과제들을 서술하면 된다. 

이 목표에 서 다음의 3개 를 제 거 하여 야 한다. 

• build 에서 생성된 .class 파일들 

$ { dir . bin } 에서 정의된 출력등록부자체를 지우기 

• javadoc 에서 생성된 문서 

${ dir . javadoc } 에서 정의된 문서등록부자체를 지우기 

• archive 에서 생성된 jar 파일 

$ { file , jar } 에서 정의된 jar 과일을 지우기 

실제로는 Ant 의 과제 〈 delete 〉 를 리용한다. 

이 번에 는 속성 편집방조기능으로 해 본다. 

《〈delete dir = “${ dir > 까지 입력하고 Ctrl+Space 건을 누른다. 그러면 그림 8-22 
와 같은 속성방조기 가 현시 된 다. 




그림 8-22. 속성방조기 
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우선 . class 파일출력등록부 $( dir . bin ) 을 선택해본다. 득같이 ${ dir . javadoc }， 
$ { file , jar } 도 지워 버 리도록 과제에 입력 하면 clean 과제가 완성된다. 

<! — ================================= 

target : clean 


< target name = “ clean ” description ^ “건립에 의해 생성되는 등록부를 지운다. ” > 
〈delete dir = “$ { dir . bin }” /> 

〈delete dir = “${ dir . javadoc } ” /> 

〈delete file = “$ { file , jar } ” /> 

〈/ target 〉 

건립파일에 추가된 clean 목표를 시험해본다. 

변경한 build . xml 파일을 보존하고 [ Ant ] 보기창에서 《 clean 》 을 선택하여 실행한 
다(그림 8-23). 



그림 8-23. clean 목표의 실행 

이처럼 Ant 편집기를 사용하면 건립파일을 빠르고도 정확히 만들수 있다. 또한 매개 
과제의 기능설명，속성의 종류，기정값 등은 Ant 의 안내서를 보지 않아도 알수 있으며 
속성이 름의 타자입 력 실수와 갈은 오유를 범하지 않을수 있 다. 


216 


錢變邊 錢變變繼繼繼 






















세 8 강. Ant 시원 


제9절. Ant 로 완성된 파일건립 

그러면 프로젝트에 대하여 build 목표를 콤파일해본다. 


Problems Javadoc Declaration S Console 然 

〈terminated〉SampleChap7 build.xml [build] [Ant Build] /Companero-1.2/jdkl.6.0/bin/java (Jul 21， 2005 4:32:45 PM) 


效 | 5S 요 | ef © 


Buildfile : /root/workspace/SampleChap7/build . xml 
build: 

[javac] Compiling 2 source files to /root/workspace/SampleQiap7/bin 

[javac] /root/workspace/SampleChap7/src/sample/Encoding.java : 1 : illegal character: \65279 
[javac] package sample; 

[javac] A 

[javac] /root/workspace/SampleGiap7/src/sample/StringEncoder . java:l: illegal character: \65279 
[javac] package sample; 

[javac] A 
[javac] 2 errors 

BUILD FAILED: /root/workspace/SampleChap7/build . xml : 17 : Compile failed; see the compiler error output for details. 
Total time: 1 second 


그림 8-24. 콤파일실패 

Eclipse 상에서 문제 가 제 기되 여 원천코드의 콤파일 이 실패하였 다. 이 것은 
[ Classpath ] 태 브에서 설명 한 클라스경 로설정 에 문제 가 있기때 문이 다. JUnit 의 JAR 파 
일이 없으므로 JUnit 관련클라스를 참조하고있 
는 부분이 모두 오유로 되여버렸다. 이것을 해 
결하기 위해서는 Ant 의 실행클라스에 JUnit 의 
jar 파일을 추가하여야 한다. 

파일추가방법에는 2가지가 있다. 

[Ant 실행시간설정]에서 추가한다. 

[8.6.4 Classpath 태 브] 에 서 설 명한것 과 
같이 건립파일 의 기 동구성 에 서 추가한다. 

기동구성에 대하여서는 이미 설명하였기때 
문에 이번에는 [Ant 실행시간 설정]에서의 파 
일추가방법에 대하여 보기로 한다. 

차 림 표띠 로부터 [ Window ] ᅳ [ Preferences ] 

를 선택하여 현시 되 는 대 화칸에 서 왼쪽의 

[ Ant ] ᅳ [ Runtime ] 이 라는 차림 표항목을 선택한다(그림 8-25). 

[Global Entries ] 을 선택한 다음 [Add External JARs ] 단추를 찰칵하여 
《/ kut / eclipse / plugins / org . junit _3. 8/ junit . jar 》 를 추가한다. 다음 [ OK ] 단추를 찰 
칵하여 설정화면을 열고 다시 한번 build 목표를 실행시켜 본다(그림 8-26). 



그림 8-25. Ant 실행시간설정 
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그림 8-26. Build 목표의 실행 


제10절. Ant 와 Junit 

마지막으로 JUnit 의 시험클라스를 실행하는 test 목표를 시험해 본다. 

이 목표의 실행을 Java 프로젝트의 건립프로쎄스의 한부분으로서 조합시켜 완전작성 
을 진행할 때마다 JUnit 로 시험 을 진행하는 기능을 실현해본다. 

8.10.1. test 목표 

목록 8_1의 build , xml 로부터 test 목표만 뽑아서 아래 와 같이 표시한다. 먼저 이 
목표의 구성 을 해석 해본다. 

(target name = “ test ” depends ^ “ build ” 
description ^ “시 험 을 진행한다. ” > 

< junit printsummary = “ yes ” > 

〈classpath location 그 “${ dir . bin }” /> 

< batchtest > 

<filetest dir = “${ dir . src . test } ” > 

〈include name = “**/* Test . java ” /> 

</ filetest > 

</ batchtest > 

</ junit > 

〈/ target 〉 

JUnit 클라스에 대해서 printsummary = “ yes ” 는 test 결과의 요점을 간단한 쓴 설 
명 문을 표시하려 고할 때 지 정한다. 여 기 까지 는 단순하지 만 그 다음에 보면 약간 추가된 
부분이 있다. 

우선 〈 classpath 〉 요소가 있다. 이것은 JUnit 로부터 시험대상클라스가 보이도록 하 
기 위 한것 이 다. < batchtest > 요소는 여 러 가지 시 험 클라스를 한번 에 실 행 하도록 하기 위 
한것 이며 실제 로 시 험클라스들을 지정 해 주고있는것은 바로아래 의 < fileset 〉 요소이 다. 
cfileset 〉 는 dir 속성에서 지정된 등록부를 기초로 하여 〈 include 〉 요소의 name 속성에서 
지정된 문자렬과 결합시켜 파일묶음을 나타낸다.《**》기호로 전체 보조등록부를 재귀적 
으로 검 색한다. 

종합해보면 이 test 목표는 dir 속성에서 지정된 등록부아래의 보조등록부를 재귀적으 
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로 검색 하고 이름이 Test 로 끝나는 클라스를 모두 검출하여 시험을 진행한다. test 목표 
를 실행해보면 결과는 그림 8-27 과 같다. 



그림 8-27. Test 목표의 실행 


8.10.2. 시험의 자동화 

코드를 작성한 다음 시 험 하고 다시 수정한 다음 시험 을 또 진행한다. 이 리 한 경우 
콤파일할 때마다 자동적 으로 시험 이 진행되도록 하려면 어떻게 해 야 하는가에 대 하여 보 
기로 한다. 이 문제는 Eclipse 와 Ant 를 서로 결합하여 간단히 실현할수 있다. Eclipse 
에는 외부도구건립 이라는 기능이 있어 프로젝트의 작성작업 을 통속화할수 있다. 이것을 
리 용하여 작성과 동시 에 Ant 목표의 실행 을 진행할수 있다. 

먼저 [ SampleChap 기프로젝 트를 오른쪽찰칵하여 [ property ] 를 선택한다. 현시된 
대화칸의 왼쪽에서 [ Builder ] 를 선택하고 [ New ] 을 찰칵한다. 이 대화칸에서 새로운 
건설도구를 추가할수 있다(그림 8-28). 


E3BSES3B3 헬 ! S5SEI 전 !^ 떼 x i 


Choose an external tool type to create: 




그림 8-28. 외부도구건립대화칸 


그림 8-29. 외부도구건립 기동구성 
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여 기서 [Ant Build ] 를 선택 하고 [ OK ] 단추를 찰칵하면 [Edit launch 
⑴ nfiguration properties ] 대 화칸이 나타난다. 먼 저 건 립 도구이 름을 결 정 한다. 이 름은 
《 TestRunner 》 라고 입력하고 [ Captureoutput ] 를 잊지 말고 선택하여야 한다. 그렇 
게 하지 않으면 실행결과를 확인할수 없다(그림 8-29). [ Buildfile ] 에 build.xml 를 설 
정 한다. 이 파일을 설정 하기 위 해서는 [Browser Workspace ] 단추를 찰칵하여 
build , xml 을 선택하여 야 한다. [ OK ] 단추를 찰칵한다(그림 8-30). 

이 x J 

Select a buMi!e: 



그림 8-30. 건립파일의 선택 

다음으로 [ Targets ] 태 브로 절 환시 켜 실 행하려 는 목표를 설정한다. 기 정 목표로 
build 가 선택되 여있는데 이것을 해제 하고 test 를 선택한다(그림 8-31). 
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그림 8-31. build 목표를 해제하고 test 목표를 선택 
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마지막으로 [Build Options ] 태브를 선택한다. 여기서는 새롭게 추가하는 건립도구 
를 어떤 시점에서 실행시키겠는가를 설정한다. 표준으로는 [After a “ Clean ” ] 와 
[During Manual Builds ] 가 선택 되 여 있 다. [During Auto Builds ] 는 특별 한 리 유가 없 
는 한 변경시 키지 않는것 이 좋다. 또한 [Launch in background ] 을 선택 해놓으면 Ant 
가 배경에서 실행되게 된다(그림 8-32). 



그림 8-32. Build Option 설정 

이상으로 설정 을 끝마친다. [ OK ] 단주를 찰칵하여 즉시 시험 해 본다. 

차림표띠로부터 [ Project ] ᅳ [Clean …]를 선택한다. 여기서는 [Clean all projects ] 
가 선택되여있다. [ OK ] 단추를 찰칵하면 지우는 동작이 실행된다(그림 8-33). 

Clean will discard all build problems and built states. The projects will be rebuilt from scratch. 

® [Clean all prqjectsj 

O Clean ^elected projects: | SampleChap7_| Browse... 

— OK I I Cancel — 



그림 8-33. Clean 의 실행 
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이 방법을 리용하면 응용프로그람건립과 득같이 API 문서를 갱신하기도 하고 또 건 
립하기 전에 불필요한 파일을 지우기도 하는 등 여러가지 처리를 할수 있다. 



그림 8-34. Clean 의 성공 
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제9장. 공동판본체계에 의한 팀개발 
제1절. 림개발 

9.1.1. 공동판본체 계 (CVS) 란 ? 

CVS (Concurrent Version System ) 란 여러명의 개발자가 참가하는 응용프로그람 
개 발(림 개 발환경 혹은 림 프로그람작성 이라고 함)에 있어서 응용프로그람코드의 판본관리 
를 진행 하기 위한 쏘프트웨어 이 다. Eclipse 에 는 이 CVS 를 리 용하기 위한 기 능이 제 공 
되여있다. 

9.1.2. 역할위주 (role base ) 의 개발법 

최 근 대 규모 웨 브응용프로그람 또는 J 2 EE 응용프로그람개 발에 서 는 역 할위 주 (role 
base ) 의 개발이 주류를 이루고있다. 

역할위주의 개발법 이 란 응용프로그람개발에 참가하는 매 개발자의 개발분야나 임무 
를 명백히 하고 여 러개의 프로그람구성요소의 개 발을 동시 병 행적으로 진행하는 형 태의 
개 발방법을 말한다. 프로젝트의 규모도 수명정도가 아니 라 수십 〜수백명 단위로 포함되는 
경 우가 많고 그 사람들로 림 을 무어 개 발을 진행한다. 그 중에 서 도 개 발되 는 응용프로그 
람 (HTML 파일， JSP 파일， JavaBeans 프로그람， Enterprise JavaBeans ( EJB ) 프로그람 
등)의 구성요소는 대단히 많고 필요한 숙련도 다양하므로 이것들을 한 사람 또는 여러명 
으로 개발하는것은 힘들다. 

실례로 사용자가 보는 화면의 설계를 맡은 사람(폐지설계가라고 부른다.)은 화면의 
설계 및 개 발만 하고 그 화면을 사용하기 위한 프로그람구성 요소에 는 일체 관계하지 않 
는다. 이러한 개발방법은 응용프로그람개발에 관해서는 매 사람이 자기의 전문분야에만 
힘을 집중하도록 할수 있지만 최종적으로는 하나의 응용프로그람으로서 동작하도록 하여 
야 하기때문에 어떤 의미에서는 그 구성요소들이 개발자전체성원에 대하여 공통으로 필 
요한 구성요소로 된다. 이것은 전체 개발성원이 적절한 시기 필요한 프로그람구성요소에 
접근조종할수 있도륵 관리를 진행할 필요가 있다는것을 의미한다. 또한 개발작업을 진행 
하는 과정 에 여 러 사람들의 요구에 의하여 프로그람코드에 변경 이 가해지 기때 문에 이 변 
경 점들을 적절히 관리하는것도 중요하다. 
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구성방식제안자 
(구성방식 설계) 




Java 프로그람작성자 
(음용로그람론리 개발) 


전문분야에 [C ᅡ르는 
개발담당의 할당 






퍼I 지설계자 

(Web UI 설계 및 개발) 



그림 9-1. 역할위주의 개발 


CVS 에서는 이와 같은 개발환경을 지원하며 자원보관 ( Repository ) 및 판본추가기 
능을 제 공해 준다. 자원보관은 일 종의 자료기 지 를 의 미하며 개 발작업 에 서 작성 된 프로그 
람코드가 도중에 보관된다. 그때에 프로그람코드의 판본을 붙이는 방법으로 판본관리를 
진행한다. CVS 는 말단기 /봉사기 형 식 으로 동작하며 자원보관은 CVS 에 의 해 관리 된다. 
다음절 에 서 CVS 의 도입방법 에 대 하여 설 명한다. 

Eclipse 는 CVS 봉사기에 접근조종하고 보관고안에 보관된 자료에 접근조종할수 있 
는 말단기기능을 제공하고있다. Eclipse 를 사용하여 CVS 봉사기 에 접근하는것으로써 림 
개발환경을 마련할수 있다. 
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9.1.3. CVS 를 리용한 개발방법 

CVS 를 리 용한 림개 발방법 은 다음과 같다. 

① CVS 봉사기 및 보관고를 준비한다. 

이미 서술한바와 같이 CVS 는 말단기/봉사기로서 동작하기때문에 우선 봉사기를 준 
비하여 야 한다. (봉사기를 준비하는 과정에 보관고가 만들어진다.) 이것에 대해서는 후에 
자세 히 설 명 한 다 . 

② 개 발코드의 기초(초기판본)를 작성 한다. 

개발의 기초코드를 작성한다. 이 코드는 전체 개발작업의 기초로 되고 이것에 대한 
기능의 추가/갱신을 하면서 작업을 진행하는것으로 된다. 

③ 기초코드를 CVS 의 보관고안에 보관한다. 

작성한 기초코드를 CVS 의 보관고안에 보관한다. 이것 에 의해 CVS 보관고안에 프로 
그람코드가 작성된다. 

④ 필요에 따라 CVS 보관고로부터 필요한 코드를 얻 고 추가/갱 신을 진행한다. 

CVS 보관고로부터 코드를 얻 고 필요한 추가/갱 신을 진행한다. 

보관고로부터 얻어낸 코드는 작업자의 국부적인 환경에 복사된다. 따라서 코드에 대 
한 추가/갱신의 수정작업은 다음에 CVS 보관고에 보관할 때까지는 보관고에 반영되지 
않 는다. 

⑤ 작업을 완료하면서 다시 한번 보관고로 수정한 코드를 되돌린다. 

국부공간에서의 작업을 끝내면서 그것을 다시한번 보관고에 보관한다. 

보통 개발작업 이 완전히 끝날 때까지는 ④，⑤단계가 반복되여 진행된다. 
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제2절. CVS 봉사기의 설치 

CVS 를 리 용한 림개 발환경 을 구축하자면 우선 〈〈 CVS 봉사기〉)를 설 치하여 야 한다. 일 
반적으로 CVS 봉사기는 UNIX 계의 조작체계상에서 작성되는 경우가 많지만 여기서는 
Windows 환경 에 서 개 발작업 을 할수 있도륵 cvsnt 라는 무료쏘프트웨어 를 사용하여 
Windows XP 상에 봉사기 를 설 치한다. 

9.2.1. cvsnt 의 판본 

cvsnt 의 최 신 안정판본은 2. 0.58 a 이 지 만 이 판본은 Eclipse 와 조합시 켜 놓으면 일 
부 불합리한 점 이 있으므로 여 기서는 다른 안정판인 2.0.51 d 를 사용한다. 

9.2.2. CVS 봉사기의 설치 

현재 CVS 봉사기 쏘프트웨 어 는 Windows 용이 므로 설 치 및 경 로는 Windows XP 경 
우에 따른다. cvsnt -2. 0.51 d . exe 를 실 행한다(그림 9-3). 



그림 9-3. 설치프로그람의 첫 화면 

[ Next ] 단추를 찰칵하면 GNU GENERAL PUBLIC LICENSE 의 동의 확인대 화칸이 
표시 된 다. 동의하는 경 우에 는 [j accept the agreement ] 를 선택한 다음 [ Next ] 단추를 
찰칵한다. 다음 디 스크상의 어 느 등록부에 cvsnt 를 설치하겠는가를 설정한다. 여 기서는 
《 C:\Program Files \ cvsnt 》 등록부에 설치한다(그림 9-4). 
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@ Setup - cusnt 

Select Destination Location 

Where should cvsnt be installed? 


미 X 

■경 


J Setup will install cvsnt into the following folder. 

To continue, click Newt. If you would like to select a different folder, click Browse. 


C:\Program Files\cvsnt 


| Browse... | 


At least 1.7 MB of free disk space is required. 


< Back || Newt > j | Cancel 


그림 9-4. 설치장소의 설정 

설 치하려 는 구성 요소를 선택한다(그림 9-5). 



그림 9-5. 설치요소들의 선택 

[ Next ] 단추를 찰칵하고 설 치하려 는 등록부이 름을 설 정한다. 이 값도 기 정 값으로 설 
정한다. [ Next ] 단추를 찰칵하고 제 공하는 봉사 등을 설정한다. 이것도 기 정 값으로 해도 
좋다. 마지막으로 확인화면이 나타나는데 여기서 [ Install ] 를 찰칵하면 설치가 시작된다 
(그림 9-6). 
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그림 9-6. 설치작업개시전 확인대화칸 

이 렇게 하면 cvsnt 가 설치된다. 지정한 장소에 실행파일 이 설치되 였을 뿐아니 라 그 
림 9-7 에서 보여준것처 럼 2개의 봉사가 등록된다. 


% Services - 日 I ③ 



봉사로써 
등록되였다. 


그림 9-7. Windows 의 봉사기능으로서 등특 

이 것을 유효로 하기 위해 콤퓨터 를 재 기동한다. 
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/ Search It: Folders |;;;卜 


9.2.3. 보관고작성 

CVS 봉사기 를 사용하자면 우선 보관고를 작성하여 야 한다. CVS 의 보관고는 특별 한 
자료기지 등을 사용하는것은 아니다. 파일체계상의 보통 등록부를 보관고로서 설정할뿐 
이다. 여기서는 《 c :\ cvsrep 》 등록부를 사용한다. 

Start 차림표로부터 조종판 (Control Panel ) 을 열어 classic 보기로 절환하면 CVS 
for NT 의 아이콘이 나타난다(그림 9-8). 이 아이콘을 두번 찰칵한다(그림 9-9). 


OK Cancel 


그림 9-9. CVS 조종판 


그림 9-8. CVS for NT 아이콘 


CVSNT 혈 

Service Status j Repositories | Advanced | SSL settings | 


CVSNT 2.0.51 d 


CVS Service 


Start 

지 



CVS Lock service 


Start 

| 제 


Stopped 


Stopped 


CVS Copyright (c) 1909-2001 Brian Berliner, david d "zoo 1 
zuhn, Jeff Polk, and other authors. 

CVSNT Copyright (C) 1999-2004 Tony Hoyle, and others; 

CVSNT comes with ABSOLUTELY NO WARRANTY - for 
details type "cvs V. 
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Address Q* Control Panel 

1 Switch to Category View 

1 See Also 1 

합 Windows Update 

v a & 

V ， ^ ^ 

산^ 츠 Add or Remove Programs Administrative Tools 

[j ■ 물 !! Adobe Gamma CMI Audio Config 

r 朴 公 


CVS for NT ，一、 ᅳ多 Date and Time 

Display 는、^ 노 Folder Options 

히 Fonts Game Controllers 

Internet Options 낫 i ) Java 

| Keyboard Mouse v 
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[repos 社 ories ] 래브를 찰칵한다(그림 9-10). 
cvsnt 는 여 러 개의 보관고를 관리할수 있 
지 만 지 금은 한개 도 등록되 여있지 않다. 
[ Add ] 단추를 찰칵하여 [ Location ] 란의 오 
른쪽 […]을 찰칵하여 [folder …]대화칸을 
연다. 여기서 \cvs 등록부를 선택하고 [Make 
New Folder ] 을 찰칵하여 [ cvsrep ] 등록부를 
작성 해 놓는다(그림 9-11). [ OK ] 단추를 찰칵 
하면 [Edit repository ] 대 화칸의 

[ Location ] 과 [ Name ] 란에 이 름들 이 채 워 진 
다(그림 9-12). 


CVSNT [■] 

Service Status Repositories | Advanced | SSL settings | 





□ K 


Cancel 







그림 9-10. 보관고 
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田 보 3.5 Floppy (A:) 八 

困 :，， BOOT (C:) 


田 건 BOOK 
& CV5REP 

+ 그 Documents and Settings 
田 Program Files 
힛 RECYCLED 
田 l£| TOOL 




- 

To view any subfolders」click a plus sign above. 


Make New Folder | | OK | | Cancel 


그림 9-11. 보관고등록부의 작성 
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그림 9-12. 보관고선택 


실제로 cvs 말단기가 이 봉사기 
에 접근할 때 [ Name ] 란에 정의된 
문자렬 을 지 정하면 된 다. [ OK ] 단추 
를 찰칵한다. \ cvsrep 등록부를 cvs 
보관고로서 초기화하겠는가를 묻는 
대화칸이 현시된다. 초기화하지 않 
으면 사용할수 없기 때 문에 [ Yes ] 단 
추를 찰칵한다. c :\ cvsrep 등록부가 
보관고로서 설정되면 [ Advanced ] 
태 브로 절환하여 [Pretend to be a 
Unix CVS version ] 검사칸을 선택 
한다. Eclipse 는 낡은 판본의 cvsnt 
와는 정합이 잘 되지 않으므로 보관 
고와의 동기화가 잘 진행되지 않는 
다. 이 설정에 의해 cvsnt 가 UNIX 
판 CVS 경 우에 비해 이 리 한 현상을 
회 피할수 있게 한다(그림 9-13). 

우의 설 정 들을 진행하여 CVS 봉 
사기로서 쓸수 있게 되였다. [ OK ] 
단추를 찰칵한다. 


CVSNT 

Service Status | Repositories Advanced | SSL settings | 
[구 Impersonation enabled 

r- Use local users for pserver authentication instead of 
domain users 

I - Don't resolve client names [debug setting] 



[구 Lockse 『 ve 『 listens locally only 
[구 Pretend to be a Uniw CVS version 


「 Enable rename (experimental) 
「 Allow trace 

Temporary Directory 


| C:\Prograrm Files\cvsnt\T emp 



CVS server port 

Lock Server 

2401 님 

jlocalhost 

[2402 

최 

Encryption | Optional 

Compression J Optional 


ij 


□ K 

Cancel 

Apt 知 


그림 9-13. Eclipse 로부터 실행시키기 위한 
조건선택 


선먹한다 
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제3절. Eclipse 를 사용한 CVS 봉사기에로의 접근조종 

9.3.1. CVS 에서 사용되는 용어 

표 9-1 에 CVS 를 리용할 때 사용되는 용어들에 대 하여 간단히 종합하였다. 


표 9-1. 

CVS 에서 사용되는 용어 

용 어 

설 명 

모 둘 
( Module ) 

판본관리대상으로 되는 파일의 집합체이다. 한개 보관고안에 여러개 
의 모둘을 등록할수 있다. 

Eclipse 에서는 1개 프로젝트에는 1개의 모둘이 대응된다. 

들여넣기 
( Import ) 

작업 대 상프로젝 트(또는 파일 )를 공유하기 위하여 보관고에 등록하는 
것을 말한다. 

꺼 내 오기 
( Checkout ) 

보관고로부터 모둘을 작업 콤퓨터 에 꺼 내 오는것 을 말한다. 

작업복사물 

꺼내온 파일들을 말한다. 실제의 편집작업은 작업복사물에 대하여 
진행한다. Eclipse 에서 는 보관고로부터 작업 공간상으로 꺼 내 온 프로 
젝트가 작업복사물이 다. 

보관하기 

( Commit ) 

작업복사물에 대하여 진행된 변경을 보관고에 등록하는것을 말한다. 
이것에 의해 보관고상의 파일에 대하여 교정 ( Eclipse 에서는 [개정] 

이 라고 한다. )이 하나씩 진행 된다. 

갱 신하기 
( Update ) 

보관고의 최근 수정 내용을 작업복사물에 반영시 킨다. 

태브 

( Tab ) 

모둘의 어떤 특정한 시점에서 파일들에 붙인 이름을 말한다. 래브가 붙여 
진 어떤 시점에서의 모둘내용을 언제나 재현할수 있다. 

줄기 

( Trunk ) 

보관고안의 기 본개 발흐름선 이 다. 

보통 처 음에 판본관리 대 상을 줄기 에 들여넣 기하여 모둘을 작성 하기 
때문에 꺼내오기，편집，보관하기 등 작업의 반복이 줄기상에서 진 
행된다. HEAD 란 줄기의 앞머 리를 나타내는 태브이 다. 《 HEAD = 줄 
기》라고 생 각해 도 된 다. 

가지 

( Branch ) 

줄기 ( Trunk ) 에 대 한 가지선을 말한다. 새 로운 기능을 추가하거 나 
오유의 수정 등은 가지상에서 진행하기때문에 줄기에 그 내용을 반 
영 (줄기 와 정 합) 하는 경 우가 많다. 
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9.3.2. 다중사용자 환경 

설치한 CVS 봉사기 ( CVS 보관고)에 Eclipse 작업대로부터 접근조종하여 실제로 CVS 
를 사용해본다. 림개발을 진행한다면 반드시 맞다드는 변경의 다투기나 정합에 대하여 
아래와 같은 실례를 들어 보기로 하자. 

이 미 7장에 서 사용한 SampleChap 7 프로젝 트를 다중개 발자가 공유하여 림 개 발을 진 
행 하도록 한다. 주요 개 발자는 cvsuserOl 과 cvsuser 02 인 2명 이 다. 개 발자는 각각 
SampleChap 7 프로젝트를 자기의 콤퓨터상의 작업공간에 꺼내여 개발작업을 진행한다. 
이러한 상황에서 2대의 콤퓨터 ( CVS 봉사기 한대， Eclipse 말단기 한대)와 1개의 Eclipse 
상에 서 재 현하는 방법 에 대 하여 설명한다. 

1) 사용자등록 

cvsuserOl , cvsuser 02 라는 2명의 사용자를 등록한다. 

표준설 치된 cvsnt 에서는 사용자를 Windows 사용자그대 로 리 용하게 되 여 있기때 문 
에 Windows 에서 이 사용자들을 등록한다. 

① [ Start ] ᅳ [Control Panel ] 을 찰칵하고 [User Accounts ] 를 찰칵한다. 

② [Create a new account ] 단추를 찰칵한다. 

③ [Type a name for the new account ：] 마당에 《 cvsuserOl 》 이라고 입력하 
고 [ next ] 단추를 찰칵한다(그림 9-14). 



cvsuserOl 
이라고 입력한다 


그림 9-14. 새로운 사용자이 ■ 설정 

④ [Computer Administrator ] 를 선택 한 다음 [Create account ] 를 찰칵한다(그림 
9-15). 
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선덕한다 


그림 9-15. 사용자부류의 선택 

⑤ 작성한 사용자에 대 해서 암호를 설정한다. 이 자 만든 사용자를 찰칵한다. 

⑥ [Create a password ] 단추를 찰칵한다. 

⑦ 암호를 작성한다. [Type a new password ] 마당과 [Type the new password 
again to confirm ] 마당에 암호를 입 력 하고 [Create password ] 를 찰칵한다(그림 9-16). 



그림 9-16. 암호의 작성 

사용자 cvsuserOl 의 작성 이 완료되였다. 꼭같은 방법으로 cvsuser 02 도 만든다. 
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2) 보관고위치의 설정 

다음 Eclipse 에서의 설정을 진행한다. [CVS Repository Exploring ] 투시로 절환하여 
cvsuserOl , cvsuser 02 의 개개의 전용보관고위치를 작성한다. 

보관고위치란 CVS 보관고의 장소나 사용자등록에 관한 정보 등을 종합한것이므로 
Eclipse 에서 CVS 보관고에로의 접근조종을 실현할 때 기준점으로 된다. 

① 차림표띠 에서 [ Window] ^ [Open Perspective ] —[ Other …]를 선택 하여 투시의 선 
택대화칸을 현시하고 [CVS Repository Exploring ] 를 선택한다. 

② [CVS Repository Exploring ] 투시가 열리면 [CVS Repositories ] 보기창에서 
오른쪽찰칵하여 펼쳐지는 차림표에서 [ New ] —[Repository Location …]를 선택한다. 

③ [Add CVS Repository ] 대화칸을 연다. Eclipse 작업대에서 CVS 보관고를 호출 
조종할수 있도륵 그 장소를 지정한다. 그림에서와 같이 정보를 입력한다(그림 9-17). 


^ ，사기 0 ! 이 BUI 
fv] vaaa? 輕 지 a 



그림 9-17. CVS 보관고추가대화칸 

• Location (CVS 보관고의 장소를 지정) 

Host ： CVS 보관고가 있는 호스트콤퓨터이 름을 지 정한다. Windows 용콤퓨터 에 봉사 
기환경 을 구축하였기때 문에 그 콤퓨터 의 망 IP 주소를 기 입하는데 여 기서 는 
<<172.29.92. 105» 로 한다. 

Repository path ： CVS 보관고가 있는 장소를 지 정한다. CVSNT 의 조종판에서 설 
정한 [ Name ] 의 값을 사용한다. 여기서는 먼저 작성한 《/ cvsrep 》 를 사용한다. 

• Authentication (CVS 보관고에서 호출조종하는 사용자정보를 지정) 

cvsnt 의 기정설정에서는 Windows 에 등록가입할 때의 사용자인증구조를 리용하게 
되여 있다. 따라서 [ User ], [ Password ] 에서도 Window 에서의 설정을 그대로 사용한다. 
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여 기 에서는 사용자 《 cvsuserOl 》 을 지 정한다. 

• Connection (CVS 보관고의 호출접근경우에 사용하는 통신규약을 지정) 

Connection type ： pserver , ext , extssh 의 3 가지가 사용가능한데 여기에서는 
pserver 를 지 정한다. 포구설 정 은 [Use Default Port ] 으로 한다 

Save password ： 이것을 선택해놓으면 암호입 력 을 재촉함이 없이 넘어 간다. 기 업 
소내 국부망과 같은 안전한 환경에서 사용하고있다면 선택해놓는것이 편리하다. 다음 
[ Finish ] 단추를 찰칵한다. 

④ CVS 보관고에로의 접속이 성공하면 그림 9-18 과 같은 화면이 펼쳐진다. 



그림 9-18. 보관고추가완성 

꼭같은 방법 으로 cvsuser 02 보관고위 치 도 작성 한다. 

사용자이름만 내놓고 나머지는 지금까지 작성한 cvsuser () l 의 보관고위치설정과 꼭 
같은 내용이다(그림 9-19). 
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그림 9-19. 사용자이■만 다르게 설정 
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[CVS Repositories ] 보기에서 보면 그림 9-20 과 같다. 



그림 9-20. 두개의 보관고위치 

9.3.3. 프로젝트를 보관고에 등록 

우선 처 음으로 진행해 야 할것 은 이 제 부터 자기 가 작업하는 프로젝 트를 CVS 보관고 
에 등록하는것이다. 여기에서는 SampleChap 7 프로젝트의 개발럼성원 cvsuser()l 이 개 
발하는 제 일 초기코드를 보관고에 등록한다. 

① SampleChap 7 프로젝트를 작업공간에 복사한다. 

② Java 투시의 패 키지열 람기 에서 [SampleChap 기프로젝트를 오른쪽찰칵하고 내부 
차림 표로부터 [ Team ] ᅳ [Share Project ] 를 선택한다. 

③ 어떤 보관고에 대 하여 프로젝트를 공유하는가를 지정 한다. 

여 기 에서는 처 음에 작성한 cvsuserOl 용보관고를 사용한다(그림 9-21). [ Next ] 단 
추를 찰칵한다. 


Share Project with CVS Re pa ： 
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그림 9-21. 보관고선택 
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④ 공유하려 는 프로젝 트를 CVS 보관고에 대 하여 어 떤 이 름으로 등록하는가를 지 정한다. 
여 기 에서는 [CVS Repository Exploring ] 투시 에 현시된 이름으로 한다. 보통 사용 
자가 작성한 프로젝 트이 름을 그대 로 등록이 름으로 하는 경 우가 많지 만 특별 히 이 름을 지 
정 할수도 있다. 여기에서는 프로젝트이름으로 모둘이름을 사용한다 (9-22). 



그림 9-22. 모듈이■의 입력 

⑤ [ Next ] 단추를 찰칵하면 CVS 보관고에 련결하는 작업이 시작되고 그후 확인화면 
이 나타난다.〉단추를 찰칵하여 계층구조를 전개시켜 보면 프로젝트파일이 보관고안의 
등록대 상으로 되 여있는것 을 알수 있다(그림 9-23). 
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그림 9-23. 보관고안에 등록된 프로젝트의 미리보기 
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⑥ [Share Project ] 대 화칸에 서 프로젝 트이 름을 오른쪽찰칵하여 펼 쳐 지 는 문맥 차림 
표로부터 [ Commit ] 를 선택한다. 그러 면 그림 9_24와 같은 대 화칸이 나타난다. 


ion Control 


There are 15 resources that are not under CVS version control. Do you want to add them? 


因田 


Details > 


그림 9-24. 보관의 미리보기 

[ Yes ] 단추를 찰칵하면 보관에 대 한 설명입 력대화칸이 현시되는데 여기서 입 력하는 
설명문은 후에 변경리력을 열람할 때에 표시되게 된다. 이 보관을 진행하는 목적에 대한 
간단한 설명 을 입 력 하고 [ OK ] 단추를 찰칵한다(그림 9-25). 

面 


a 田 

Edit the commit comment: 


Choose a previously entered comment: 


그림 9-25. 보관에 대한 설명입력칸 

《 언제》，〈〈 어 느 파일 을 보관하였는가》는 CVS 가 기 록해 두기 때 문에 사용자가 입 력 
할 필 요가 없 다. [ OK ] 단추를 찰칵하면 그림 9-26 과 같은 화면 이 나타난다. [ Finish ] 단 
추를 찰칵하여 완료한다. 




그림 9-26. 보관의 완료 
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⑦ 작업공간상의 프로젝트에 어떤 변화가 일어나는가 확인해본다. 

Java 투시 안의 [Package Explorer ] 보기 에 서 공유된 프로젝 트 ( SampleChap 7) 를 
오른쪽찰칵하여 나타나는 문맥차림 표에 서 [ property ] 를 선택하면 화면 안쪽에 [ CVS ] 라 
는 항목이 추가되여있고 ( HEAD ) 가 붙어있는것을 알수 있다(그림 9-27). 
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그림 9-27. 프로젝트의 속성 

⑧ 지금 상태를 CVS 보관고측에서 다시 한번 본다. 

[CVS Repository Exploring ] 투시 로 절 환하고 [CVS Repository ] 보기 에서 CVS 
보관고위 치 의〉단추를 찰칵하여 전개한다. [ HEAD ] ᅳ [SampleChap 기 을 전개 해 본다. 
그러면 그림 9-28 과 같은 결과가 나타난다. 
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그림 9-28. 보관고에 등록된 프로젝트 
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프로젝트가 무사히 보관고에 등록된것을 볼수 있다. 파일의 옆에 있는 수자는 [교정 
번히이다. 이것은 파일의 판본을 표시하며 초기값은 1.1 이다. 

9.3.4. 보관고로부터 꺼내오기 

앞절에서 는 SampleChap 7 프로젝트를 보관고에 등록하고 림개 발을 할수 있는 준비 
를 갖추었다. 

이 절에서는 개발림의 매 성원이 프로젝트를 보관고로부터 꺼내서 개발을 진행하는 
방법 에 대 하여 설명 한다. 여 기서 는 SmapleChap 7 프로젝트의 개 발럼성 원 cvsuser 02 가 
SampleChap 7 프로젝트를 보관고로부터 꺼내오는 실례를 보기로 한다. 실제로 림개발에 
서 는 cvsuser 02 가 자기의 를퓨터의 작업 공간으로 꺼 내 오기하지 만 여 기서는 한대의 를 
퓨터 상에서 한개 의 Eclipse 작업 공간에서 림 개 발을 진행 한다는데 주의 를 돌려야 한다. 

우선 cvsuserOl 이 SampleChap 7 을 보관고에 등록한것과 같은 작업공간상에 
cvsuser 02 가 보관고장소에 서부터 SampleChap 7 프로젝트를 꺼 내 온다. 일반적 인 꺼 내오 
기 를 진행하면 프로젝 트이 름이 충돌하기 때 문에 《 별명 꺼 내 오기》를 진행한다. 

① [CVS Repository Exploring ] 투시로 절환하여 cvsuser 02 의 보관고위치의 
[ HEAD ] 를 전개하여 [ SampleChap 기을 오른쪽찰칵하고 [Check Out As (별명 꺼내오 
기)]를 선택한다. 

② [Project Name ] 마당에 [ SmapleChap 7_02] 라고 입 력 하고 [ Finish ] 단추를 찰칵 
한다(그림 9-29). 
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그림 9-29. Check Out As 


이 렇게 함으로써 cvsuser 02 에 의해 프로젝트가 작업 공간상에 현시되 였다. 
③ [ Java ] 투시로 절환하여 작업공간을 확인한다(그림 9-30). 
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Hierarchy 


1 □ 


「> 略 4 | [B 할 

I> t^SampleChap7_02 [172.29.92.105] 


► ^SampleChap? [172 계 . 9Z105J 


그림 9-30. 두개의 프로젝트 

2개의 프로젝트를 정확히 꺼 내왔다. 

이것으로 SampleChap 7 에 대한 작업은 cvsuserOl 사용자로서， SampleChap 7_02 
에 대한 작업은 cvsuser 02 사용자로서 각각 보관고에 보관되고 한대의 콤퓨터상에서 하 
나의 Eclipse 로 다중사용자에 의한 림 개 발환경 이 마련되 였 다. 

9.3.5. 표식자장식의 설정 

보관고로부터 프로젝트를 꺼내올 때〈〈표식자장식》이 라는 기능을 리용해보기로 한다. 
이것을 리용하면 CVS 보관고와 관련된 작업공간상의 자원에 여러가지의 CVS 관련정보 
(자료보관이름，가지 이름，교정번호 등)를 표시할수 있다. 

표식 자장식 을 설정 하자면 [ Window ] ᅳ [ Preferences ] 를 선택하여 [ Preferences ] 
대화칸을 현시한다. [ Workbench ] —[Label Decorations ] 을 선택하여 [Available 
label decorations ] 의 [ CVS ] 를 선택 한 다음 [ OK ] 단추를 찰칵한다(9_31) . 
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그림 9-31. 표식자장식의 설정 
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然 Hi 


Hierarchy 


# % | 0 % ▼ 


▼ i^SampieChap7 [172.29 . 볘 )5] 


니최 sr〔 


▽ 5 am pie 

[> ® EncoderMain.java 1.1 (A SC El -kkv) 
t> 0 Native2A5ciiEncoderjava LI fASCEI -I 
t> 0 ROTIBEncoder.java 1.1 (ASCII -kkv) 
t> ④ String Encoder.java 1.1 fASCEi -kkv) 

1> 려 test 


I> |\JRE System Library [jdkLG.O] 

I> £ JUNIT_HOME/jumt.jar - /Companero-1.2/pjug 
®bmld.xm! 1.1 fASQE -kkv) 


그림 9-32. 표식자장식 없음(왼쪽)，표식자장식 있읃(오른쪽) 


제4절. 보관고와 동기맞추기 

개발자는 자기의 작업공간에 꺼내온 프로젝트에 대하여 작업을 진행한다. 작업의 결 
과를 림에서 공유하자면 개발자들이 개별적으로 진행한 변경을 보관고에 등록하여야 한 
다. 이것을〈〈보관하기》라고 한다. 또한 반대로 다른 개발자가 보관한 변경내용을 자기 
의 작업공간에로 불러들일 필요도 있다. 이렇게 하는것을《갱신하기》라고 한다. Eclipse 
에서는 이것을 [Team synchronization ] 투시에서 일괄적으로 취급한다. 

9.4.1. 발신변경 

여 기 서 는 SampleChap 7 프 무- 젝 트의 개 발럼 성 원인 ( cvsuserOl } 가 Native 2 AsciiEncoder . java 
에 변경을 가한다. 실례를 들어보기로 하자. 

cvsuserOl 은 이 변경을 보관고에 보관한다. 

一 Native 2 AsciiEncoder . java 의 변경 

여 기 서 는 cvsuserOl 이 Native 2 AsciiEncoder . java 의 클라스설명 부분에 서 aversion 래 
그에 CVS 의 열쇠어인 《$ Revision $> 을 써넣는다. 

우의 례 에서 본 《$ Revision $> 은 무슨 의 미를 담고있는가. 

CVS 에서는 열쇠어를 원천파일에 써놓으면 보관할 때 교정번호를 자동적으로 써넣 
고 《$ Revision :1.2$》 라고 표현한다. 우의 례와 같이 ^ Version 태 그에 《$ Revision $》 
을 써 넣 으면 API 문서를 생성할 때 클라스의 판본으로서 CVS 교정 번호가 표시되 기때문 
에 편 리하다. 

그밖에 자주 리 용되는 열쇠어를 다음의 표에 주었다. 
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표 9-2. 

주요 열쇠어 


열 쇠 어 

설 

명 

$Author$ 

보관을 진행한 사용자이 름이 다. 



$ Author ： cvsuser01$ 


$Date$ 

보관이 진행된 시간이다. 



$Date ： 2005/09/19 18:30:45$ 


$Id$. 파일이름，교정，날자시간 등을 써넣는것만으로 모든 정보가 기록된다. 

$Id : Sample.java,v 1.3 2005/09/19 18:30:45 cvsuserOl Exp$ 

$Log$ 파일이름，교정，보관날자，보관사용자이름이 추가되여〈〈보관하기》통 

보문의 리력 으로 치 환된다. $Log$^ 행의 앞머 리사이 에 있는 문자(아 
래의 례에서는《*》)가 다음행의 앞머 리 에도 입 력되 기때 문에 아래의 례 
와 같은 설명문만으로 $Log$l- 서술해도 착실히 리력이 남는다. 

/** 

* $Log ： Sample, java, v $ 

* Revision 1.3 2005/09/19 18:30:45 cvsuserOl 

* 열쇠어 치 환시 험 

* 

* Revision 1.2 2005/09/19 18:15:45 cvsuserOl 

* 오유 ID 12345 를 수정 

* 

* Revision 1.1 2005/09/19 18:10:45 cvsuserOl 

* *** 기록통보가 없음 *** 


*/ 


— 차이 나는 부분의 확인 

패 키지 열 람기 에서 프로젝트이 름을 오른쪽찰칵하여 [Team]— [Synchronize with 
Repository] 를 찰칵한다. 투시 절환확인대 화칸이 나타나면 [OK] 단추를 찰칵하여 
[Team Synchronizing] 투시에로 절환한다(그림 9-33). 
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그림 9-33. [ Synchronize ] 투시 

기본은 [ Sychronize ] 보기이다. 이 보기에서는 작업공간과 보관고의 상태에서 어떤 
차이가 있는가를 비교해볼수 있다. 

프로젝트를 오른쪽찰칵하여 [Expand All ] 를 선택 하면 [ Native 2 AsciiEncoder . java ] 에 
변경이 가해졌는가를 알아볼수 있다. 회색의 오른쪽화살표식은 작업공간의 파일에 변경 
이 가해졌다는것을 표시하고있다(그림 9_34). 



그림 9-34. [ Synchronize ] 의 보기 


파일을 두번찰칵하면 변경내용을 확인할수 있다(그림 9-35). 
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그림 9-35. 작업공간과 보관고와의 차이 비교 


① Java 구조체 의 비교 

국부파일(작업공간)，원격파일(보관고)의 2개 파일의 차이 가 표시된다. 이 례에서 
는 설명 문만 변경하였 으므로 구조상 차이 를 찾아볼수 없 다. 

② 국부파일 

작업공간의 파일내용이다. 파일이름옆의 《1.1》이란 수자는 이 파일이 보관고상의 
교정 1.1 을 꺼 내 온것 임 을 표시한다. 

③ 원격파일 

보관고의 파일내용이다. 《1.1》이라는 수자 역시 교정번호이며 이 파일의 최신판이 
교정 1.1 이라는것을 표시하고있다.(결국 초기상태 그대로라고 말할수 있다.) 이것으로 
cvsuser () l 은 자기의 작업공간의 파일과 보관고의 파일의 차이를 확인할수 있다. 

一 보관고에 보관 

다음에 이 국부적인 변경을 보관고에 보관한다. [ Synchronize ] 보기의 [Outgoing 
Mode (전체 발신변경 을 저 장한다)]단추를 찰칵한다(그림 9-36). 
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그림 9-36. 발신변경의 보관 
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보관설명입 력대화칸이 표시되기때문에 설명을 입 력 하고 [ OK ] 단추를 찰칵한다. 이것으 
로 동기화가 완료되고 작업공간과 보관고의 내용은 완전히 일치되였다. 그리고 Java 투시로 
절환해 본다. [Package Explorer ] 보기를 보면 명확히 Native 2 AsciiEncoder . java 가 1.2 
로 되여있는것을 확인할수 있다(그림 9-37). 



그림 9-37. 교정번호의 증가 

9.4.2. 착신변경 

여 기서 는 cvsuserOl 이 진행한 변경 을 cvsuser 02 이 자기 의 작업 공간으로 끌어 들이 
는 경우에 대하여 보기로 한다. Cvsuser 02 의 작업 이므로 [ SampleChap 7_02] 프로젝트 
에 대 하여 진행한다. 

一 변경내용의 확인 

[ SampleChap 7_02] 프로젝 트를 오른쪽찰칵하여 [ Team ] — [Synchronize with 
Repository ] 를 찰칵한다. 투시 로 절환하여 확인대 화칸이 펼쳐 진 경 우 [ OK ] 단추를 찰 
칵한다. 푸른색의 왼쪽화살표는 보관고에 새로운 변경 이 있다는것을 알려준다. 교정번호 
가《1.1-1.2》와 같이 2개 나란히 표시되여있는데 왼쪽은 작업공간에서 파일의 교정번 
호이고 오른쪽은 보관고에서 파일의 최신교정번호이다(그림 9-38). 



그림 9-38. 착신변경의 확인 

이 파일을 두번 찰칵하여 변경 내 용을 확인해본다(그림 9-39). 
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그림 9-39. 변경내용의 확인 

클라스설명 에 9 version 태 그가 추가되 여있는것 을 볼수 있 다. cvsuserOl 에 의 하여 
보관고에 보관될 때 $ Revision $ 열쇠 어가 [$ Revision ： 1.2$]이 라고 교정 번호를 포함하 
는 형식으로 보관되였기때문이다. 

一 갱 신하기 (보관고의 내 용 끌어 들이 기 ) 

보관고의 최 신내 용을 작업 공간으로 끌어 들인다. [ Synchronize ] 보기 에서 프로젝 트 
를 오른쪽찰칵하고 [ Refresh ] 를 찰칵한다. [ Java ] 투시로 절환하여 변경내용이 들어 
온것 을 확인해본다(그림 9-40). 
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그림 9-40. cvsuser 이에 의한 변경이 cvsuser 02 의 내용에 반영 
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9.4.3. 변경의 다투기 

여기서는 다음의 경우에 대하여 상정한다. 

cvsuserOl 은 Native 2 AsciiEncoder.java 에 변경을 가하고 보관고에 보관하였다. 
cvsuser 02 는 그것을 모르고 비숫한 변경을 득같은 파일에 가하고 보관하려고 한다. 이 
와 같이 여러 성원이 파일의 득같은 부분을 동시에 변경시키려는것을《변경의 다투기》 
라고 한다. 여 기서는 다투기 가 어떻게 일 어나며 그것을 어떻게 해소시 키겠는가에 대 하여 
설 명 한다. 

— cvsuserOl 의 변경 

cvsuserOl 은 Native 2 AsciiEncoder.java 의 클라스설명을 편집하고 아래와 같이 
8 au 比 Lor 태그에 자기의 사용자이름을 기입하고 보관하였다. 


I%% 

* Native 2 Ascii 방식의 부호화기 


* Qauthor cvsuserOl 

* aversion $ Revision ： 1.2$ 
*/ 


— cvsuser 02 의 변경 

cvsuserOl 이 진행한 변경 을 알수 없는 cvsuser 02 는 우연히 도 득같은 
Native 2 AsciiEncoder . java 에 대 하여 비숫한 변경 을 해 버 린다. 즉 클라스설명 을 편집 
하고 ^author 태 그에 자기의 사용자이름을 기 입한다. 이 두 사람은 서 로 《 이것은 내 가 
쓴것 이 다.》라고 주장할것 이 다. 


I%% 

* Nantive 2 Ascii 방식의 부호화기 


* Sauthor cvsuser 02 

* aversion $ Revision ： 1.2$ 
*/ 


cvsuser 02 는 이 변경 을 보관하려 고 [Synchronize with Repository ] 를 선택 하였 
다. 같은 행 을 매 개 사용자가 변경한 자리는 비 교편집 기 에서 붉은색표식 이 붙고 다투기 
가 진행되고있다는것을 나타낸다(그림 9-41). 
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그림 9-41. 변경의 다투기 


一 다투기의 해소 

[Synchronize with Repository] 를 선택하여 다투기 상황에 직 면한 개 발자(이 례 
에서는 cvsuser02) 에게 는 먼저 해 야 할것 이 있다. 다투기상대 (이 례 에서 는 
cvsuserOl) 와 상론하여 정 확한 코드를 결정하는것 이 다. 

그 결과에 의해 

경우1: 상대방의 코드를 채용하려는 경우 

[Sychronize] 보기 에 서 프로젝 트를 오른쪽찰칵하여 현시 되 는 문맥 차림 표로부터 
[Override and Update] 을 선택하면 보관고의 내 용으로 작업 공간의 내 용이 갱 신된다. 
경우2: 자기의 코드를 채용하려는 경우 

[Sychronize] 보기 에 서 프로젝 트를 오른쪽찰칵하여 현시 되 는 문맥 차림 표로부터 
[Override and Commit] 를 선택하면 작업 공간의 내 용이 보관고에 보관된다. 

경우3: 쌍방의 코드를 정합하려는 경우 

비교편집기에서 쌍방의 코드의 차이점을 비교하면서 정합할수 있으며 보통 Java 편 
집기에서 원천을 편집하고 보관한다. 

여 기에서는 cvsuserOl 과 cvsuser02 의 상론결과 다음과 같이 하기로 합의하였다고 하자. 

이 클라스는 cvsuser()l 과 cvsuser02 의 공동작이므로 ^author 태그를 하나 추가하 
여 쌍방의 사용자이 름을 렬거하기 로 한다. 이 합의 는 쌍방의 코드를 정 합하는〈〈 경 우3》 
에 해당된다고 말할수 있다. [Java] 투시로 절환하여 Native2AsciiEncoder.java 를 아 
래 와 같이 편집한다. 
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I%% 

* Nantive 2 Ascii 방식의 부호화기 


* Qauthor cvsuserOl 

* Qauthor cvsuser 02 

* aversion $ Revision ： 1.2$ 

*/ 

여기서 작업공간의 Native 2 AsciiEncoder.java 는 합의에 따라 보관고에 보관하여 
야 할 내용으로 되였다. 다음에 이것을 보관하는 작업을 보기로 한다. [ Ctrl ] + [ S ] 로 
Native 2 AsciiEncoder . java 를 보존한다. 

— 보관하기 

이상으로 파일의 내용으로서는 다투기가 해소되였다. 그러나 Eclipse 는 아직 그것 
을 인식 하지 못한다. [ Sychronize ] 보기 에서 [ Native 2 AsciiEncoder . java ] 를 오른쪽찰 
칵하여 현시 되 는 문맥차림 표로부터 [Mark as Merged ] 을 선택한다. 그러 면 
[ Native 2 AsciiEncoder . java ] 는 정합에 따라 다투기가 해소되였다고 확인되고 다투기 
정 합이 발신변경표식 으로 변한다(그림 9-42). 



그림 9-42. 변경의 다투기가 해소되고 발신변경표식으로 변한다 

마지막으로 진행된 변경을 보관고에 보관한다. 




그림 9-43. 해당한 설명문작성 
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Rnish 


Cancel 


그림 9-44. [ Update ] 대화칸 


이것으로 cvsuserOl 의 SampleChap 7 프로젝트는 최신상태로 되였다. 
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— cvsuser()l 측을 갱신 

cvsuser 02 가 다투기를 해소한 결과를 보관하였다. 이것으로 Native 2 AsciiEncoder . java 
는 한개 교정 이 더 진행되였다. cvsuser()l 의 프로젝트는 이 최신교정을 받아들일 필요 
가 있다. 

이 번에 는 [Team Synchronizing ] 투시 를 리 용하지 않고 간단히 갱 신을 진행 해 본다. 
[ Java ] 투시로 절 환하여 [Package Explorer ] 보기에서 [SampleChap 기 프로젝트를 오 
른쪽찰칵하여 [ Update ] 를 선택한다. [ Update ] 대 화칸이 표시 되 면 [ Finish ] 단추를 찰칵 
한다(그림 9-44). 




SelectTag 

]cv$i 

=^= 

Select the tag far the update 

® U.se the tag currently associated with the workspace 

_■] ■ Select the tag from the following list 

resources 


Refresh from Re p osltory Conflgu re ᅭ - 


D 

HEA 」 

tH 分德 # {i 
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제 5 절. 태그(판본) 


CVS 에서는 보관고에 첫 파일이 보관될 때 《1.1》이라는 교정번호가 붙는다. 그리 
고 파일을 갱신하면 《1.2， 1.3 …》라고 교정번호는 올라간다. 이 교정번호에 의해 이 
전의 교정번호내용을 얻거나 2개의 교정번호사이의 차이를 명백히 할수 있다. 그러나 
이 《교정번호》는 어 디까지 나 개 개의 파일에 붙은 번호이다. 프로젝트에는 보통 여 러 개 
의 파일이 있고 개발이 진행되는데 따라서 개개 파일의 교정번호는 제가끔 되여있다. 그 
러므로 프로젝트의 임의의 한 시점에서 전체 파일에 대하여 교정번호가 얼마였는가를 기 
억해두어야 한다. 이것은 매우 불편하다. 그래서 CVS 에서는《태그》라는 개념을 도입 
하는데 이것은 여 러개의 파일묶음에 대 한 판본번호이다. 

그림 9-45 에 태 그의 모양을 주었 다. 5개 의 파일로 되 여있는 프로젝 트에 《 vl _0》 과 
《 v 2_0> 인 2개의 태 그가 붙어 있다. 이 렇게 태 그이름들을 지정하는것으로써 프로젝트전 
체에 대한《과거의 어떤 시점》에서의 상태를 정확히 파악할수 있다. 


파일 1 


5^2 


파일 3 


5^4 


urns 


1.1 —ᅡ 1.2 


1/1 


1.1 


1/1 


1.1 


1.2 


1.2 ―- 1.3 


1,3 


1.4 


1.2 


1.3 


1,5 


1.2 


조기상31 


VI _0 


1,3 


1.3 


1.5 


1.2 


1.2 


v2_0 


그림 9-45. 태그의 모양 


9.5.1. 프로젝트에 태그를 붙인다. 

여기서는 SampleChap 7 프로젝트의 개발럼성원인 《 cvsuserOl 》이 현재의 
SampleChap 7 프로젝트에 태그 [ vl _0] 을 붙이는 경우에 대하여 보기로 한다. 

① [Package Explorer ] 보기 에 서 프로젝 트를 오른쪽찰칵하고 내 부차림 표로부터 
[ Team ] ^ [Tag as Version ] 을 선택 한다. 

② [Tag Resources ] 대 화칸에 서 태 그(판본) 이 름을 입 력 하고 [ OK ] 단추를 찰칵한다 
(그림 9-46). 
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@ 田 


Please enter a version tag: 



□ Mwe tag if it already exists 

v 1_0 이라고 입력 


OK 


Caned 


Details » 


그림 9-46. 판본 이■을 입력 

이것으로 태그(판본)를 붙이는 작업을 완료한다. 

③ [CVS Repository Exploring] 투시 에 서 확인해 본다. 

[CVS Repository Exploring] 투시 로 절 환하여 [CVS Repository] 보기 의 
[Version] 을 찰칵하여 전개한다(그림 9-47). 



그림 9-47. 판본확인 


보관고안에 판본이 작성 되 여있는것 을 볼수 있다. 

9.5.2. 판본을 지 정하여 꺼 내 오기 

프로젝트의 과거 상태를 참조하려는 경우 판본을 지정 하여 꺼내 오면 판본을 붙인 시 
점에서의 프로젝트내용을 얻을수 있다. 

① 꺼내려는 판본을 선택 

[CVS Repository Exploring] 투시로 절 환하여 [CVS Repository] 보기의 
[Version] 을 찰칵하여 전개한다. 

② 꺼내려는 판본을 선택하여 오른쪽찰칵하고 내부차림표로부터 [Check out As] 를 
선택한다(그림 9-48). 
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그림 9-48. 프로젝트이 ■ 설정 

[ Import ] 를 선택 했을 때 작업 공간상에 프로젝트가 이 미 존재하는 경우에 대 해서 는 
우에서 서 술되 였기때 문에 이 례 에서는 [Check out As ] 를 사용한다. [ Finish ] 단추를 찰 
칵하면 꺼내오기가 진행된다. 

③확인해 본다. 

[ Java ] 투시로 절환하여 [Package Explorer ] 보기에서 확인해 본다(그림 9-49). 판 
본(태그)이름이 표식자장식으로서 되여있는것을 볼수 있다. 



그림 9-49. 판본지정으로 꺼내온 프로젝트 

주의 : 즉 판본을 지 정하여 꺼 내 오기한 프로젝 트는 Eclipse 상에 서 편집할수 있지 만 
보관고에 보관하는것은 불가능하다.《보관하기》조작자체는 선택할수 있지만 그림 9-50 
과 같은 오유가 나와 실패한다. 
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그림 9-50. 판본붙인 프로젝트에 대하여 보관실패 

과거판본의 프로젝 트내 용으로 되 돌아가서 개 발을 계 속 진행하려 는 경 우에 는 [9.5.4. 
과거의 판본에로의 되돌아가기]를 참조한다. 

9.5.3. 판본을 지 정하여 비 교 

판본을 지정하여 프로젝트의 내용을 비교할수 있다. 

一 작업공간과의 비교 

작업공간의 프로젝트를 보관고의 특정의 판본과 비교할수 있다. 

여 기서 는 SampleChap 7 프로젝트의 개발림성 원인 cvsuserOl 이 판본 [ vl _0] 의 공개 
후 Native 2 AsciiEncoder . java 의 클라스설명 문을 편집 한 경우 그 프로젝트를 [ vl _0] 
과 비교하는 실례를 보기로 한다. 

편집 내 용은 Native 2 AsciiEncoder . java 클라스의 설명 문에 아래 와 같은 하나의 문 
장을 추가한것 이 다. 

* Nantive 2 Ascii 방식의 부호화기 

* Nantive 2 Ascii 설명문과 꼭같이 문자렬을 유니코드화한다. 

* 

* Qauthor cvsuserOl 

* Qauthor cvsuser 02 

* aversion SRevision ： 1.4$ 

*/ 

① Java 투시의 [Package Explorer ] 보기 에서 프로젝트를 오른쪽찰칵하여 내부차림 
표로부터 [Compare with ] ^ [Another Branch or Version ] 을 선택 한다. 

② 비교대상판본을 선택 

[Compare With Branch or Version ] 대 화칸에 서 비 교대 상판본을 선택 한다(그림 
9-51). 
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그림 9-51. [Compare With Branch 아 Version ] 대화칸 

이 례에서는 [ vl _ 이을 선택하여 [ OK ] 단추를 찰칵하면 비교결과가 나타난다(그림 9-52). 



그림 9-52. 비교결과의 현시 

아래 에 서 보게 되 는 [보관고안의 서 로 다른 2개 판본의 비 교]에 서 사용하기 위해 
여기에서 현재의 SampleChap 7 에 판본 [ vl _ l ] 을 붙여놓자. 즉 판본은 작업공간상의 프 
로젝트는 아니고 보관고안의 상태에 대하여 붙인것 이다. 작업공간상에 보관하지 않은 변 
경이 있는 경우 보관하여야 하기때문에 판본을 붙일 필요가 있다(그림 9-53). 
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그림 9-53. 판본 [ vlj ] 을 입력 

一 보관고안의 서 로 다른 2개 판본에 서의 파일 비 교 

보관고안에 여 러개 판본이 존재 하는 경우 [CVS Repository Exploring ] 로부터 그것 
들을 비교할수 있다. 여기서는 SampleChap 7 프로젝트의 개발성원 cvsuserOl 이 [ vl _0] 
과 [ vl _ l ] 의 차이를 조사하여 내용비교를 진행한다. 

① [CVS Repository Exploring ] 투시로 절 환한 다음 [CVS Repository ] 보기의 
[ Version ] 을 찰칵하여 전개한다. 

② 비교대상판본을 2개 선택한다. 이 례에서는 [ vl _0] 과 [ vl _ l ] 를 선택한다(그림 9-54). 


CVS Repositories 

_、 ^CVS Annotate 

^ 

B 

m ▼□日 


▽ Q :pse[ver:cv5U5er01@172.29.9'2.105:/cv5rep 


t> t HEAD 
t> Branches 
▽ ^Versions 
l> t^CVSROOT 
|> gloss ary 
t> ^My 
I> S Recycled 
▽ 혈 Sampled hap7 


r SampleChap7 vl_l 
r SampleChapZ vl_0 


]> Work set 
P 혈 : zzz 
Dates 

§ 3 : pseFvercv s u ser02 @172.25.92.105 :/cv s rep 



그림 9-54. 비교대상판본의 선택 

③ 내 부차림 표로부터 [ Compare ] 를 선택하면 비 교결과가 현시 된다. 

[Structure Compare ] 에 서 Native 2 AsciiEncoder . java 를 두번찰칵한다(그림 9-55). 


258 錢變邊錢變變繼繼繼 
































세 3 장. 훙444세게에 의4 깊개•參 



그림 9-55. 비교결과를 현시 

9.5.4. 이전의 판본에로 되돌아가기 

CVS 에서 개발하는 경우 정확하게 동작하던 때의 판본으로 되돌아가야 할 경우가 
있다. 이리한 경우 CVS 에서는 과거의 판본내용을 작업공간에 올려쓰고 그것을 다시 보 
관고에 보관하는 조작을 할수 있다. 여기서는 SampleChap 7 프로젝트의 개발림성원 
cvsuserOl 이 프로젝트안의 내용을 vl _0 때에로 되돌리 려는 경우에 대 하여 보기로 한다. 

순서는 9.5. 3.에서 본 [작업공간과의 비교]와 득같기때문에 되돌리려는 판본을 선 
택하는데 까지 는 략한다. 

① [ Synchronize ] 보기의 [SampleChap 기을 오른쪽찰칵하고 내부차림표로부터 
[Override or Update ] 을 선택한다. 

② 작업 공간의 올려 쓰기 에 대 한 확인대 화칸이 표시 된 다. [ OK ] 단추를 찰칵하면 보관 
고의 [ vl _0] 의 내용이 작업공간에 복사된다(그림 9-56). 


ga 考 면 

必 分 屈 ▼ᄆ □ 

CVS Compare Vl ff (/SampleChap7) 


No changes in 'CVS Compare 노1_0" (/SampleChap7)\ 


그림 9-56. v 1_0 의 내용과 일치시켰으므로 변경점이 없어진다 

③ 보관을 진행한다. 
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제6절. 가지 ( Branch ) 

이 장의 지금까지의 례에서는 보관고안의 리력을 언제나 하나의 흐름처럼 취급해왔 
다. 파일의 교정이 1.1 ᅳ 1.2 ᅳ 1.3 ᅳ 1.4 이렇게 진행되고있는 이 《흐름》을 CVS 의 용 
어 로는《 줄기 ( trunk ) 》라고 한다. 

개 인 또는 여 러 명짜리 림개 발이라면 언제 나 줄기 만을 대상으로 개 발을 진행하는것도 
가능하다. 그러나 실제의 체계개발에 있어서는 이와 같이 단순하지 않다. 례들어 아래와 
같은 상황에 대하여 생각해본다. 

자신이 어 떤 응용프로그람의 개발림 에 속해 있 다. 이 전에 출하를 기 다리 던 판본 1.0 
을 완성하여 구입 자에 게 넘 겨 주었 다. 그 상태 를 기 록하기 위하여 보관고에 는 판본 
[ vl _()] 을 불였다. 그후 오유보고가 1건，기능추가요청이 1건 제기되였다. 오유수정에 
는 개 발자 3명 과 2주일의 시 간을 투하하고 수정 판 [ vl _ l ] 로 하여 공개하도록 되 였 다. 
기 능추가는 좀 더 고려하여 5명 으로 된 림 이 조직 되 여 1개 월동안에 [판본 1.5] 로서 공 
개판을 내놓도륵 하였다. 

그러면 어떻게 할것인가. 오유수정，기능추가의 량림쌍방이 줄기로부터 프로젝트를 
꺼내서 각각 수정을 조금씩 하면서 보관하면 어떻게 될것인가. 이렇게 하면 때때로 다투 
기 가 발생 하고 작업 에 지 장을 줄수 있 다. 례하면 쌍방에 서 수정할 파일 이 달라지 고 다투 
기가 발생하지 않았어도〈〈기능추가의 도중상태》에〈〈오유수정의 도중상태》코드를 혼합 
하는것으로 된다. 이것은 절대로 허용될수 없는 일이다. 역시 오유수정림，기능추가림의 
쌍방에 한개의 최신안정판인 [ vl _0] 을 기초로 하였기때문에 각각 전용의 개발흐름이 요 
구된다. CVS 의 《가지》기능을 사용하면 이것을 실현할수 있다. 이 경우 오유수정，기 
능추가를 실현할수 있는 각각의 전용가지 를 작성 하고 그림 9-57 과 같은 병 행작업 을 진 
행하면 된 다. 
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그림 9-57. 가지를 리용한 병행작업 
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여기서는 가지를 리용한 실례에 대하여 보기로 한다. 우에서 설명한 여러개 가지에 
의 한 병행 개 발은 약간 설명 이 복잡해 지 기 때 문에 아래 와 같은 간단한 경 우에 대 하여 취 급 
하기 로 한다. 

SampleChap 7 개 발림 에 있어 서 Rotl 3 Encoder . java 의 개 편을 진행 한다. 변경 은 
[ BranchOl ] 에 서 진행한다. 

一 가지 의 작성 

① [Package Explorer ] 보기 에 서 프로젝 트를 오른쪽찰칵하고 내 부차림 표로부터 
[ Team ] ᅳ [ Branch ] 를 선택한다. 

② [Create a new CVS Branch ] 대화칸이 현시되는데 가지 이름 《 Branch () l 》 을 
입 력 한다. 

[Version Name ] 은 가지 를 작성 하는것 과 동시 에 줄기 상에 붙은 판본 (태 그) 이 다. 후 
에 [가지 의 정 합] 작업 을 진행할 때 요구된다(그림 9-58). 



그림 9-58. 가지이■의 입력 

[ OK ] 단추를 찰칵한다. [Start working in the branch ] 칸을 선택하면 보관고안에 
가지 가 작성 될뿐아니 라 작업 공간상의 프로젝 트와 련관되 기 도 한다. 

③ 프로젝트의 속성을 보면서 가지와 관련되였는가를 확인해본다(그림 9-59). 




그림 9-59. 프로젝트와 가지의 련관 
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명확히 프로젝트가 [BranchOl] 에 관련된다. 

이후의 변경은 줄기가 아니라 가지에 대응되여 보관하게 된다. 

다음에 나오는 [가지 의 정 합] 에서 는 가지 상에서 진행한 변경 을 줄기 에 정 합하는 방 
법 을 설명하는데 이것을 실현하기 위 해서 가지상에서 몇 가지 변경 을 진행해 본다. 여기 에 
서는 [Rotl3Encoder.java] 의 클라스설명에 아래와 같은 변경을 가해본다. 

/** 

* ROT13 방식의 부호화기 

* ROT13 이란 자모순의 매 문자를 13 문자씩 편차시킨것 

* 단순히 읽기 어려운 알고리듬 


* Qauthor cvsuserOl 

* aversion $Revision$ 
*/ 


— 가지의 정합 

가지 상에서 진행 한 변경 을 줄기 (또는 다른 가지)에 적 용하는것 을 가지를 정 합한다고 
한다. 여기에서는 SampleChap7 프로젝트의 개발림성원 cvsuser()l 이 가지 [BranchOl] 
의 내 용을 줄기 (HEAD) 에 정 합하는 방법 에 대 하여 보기 로 한다(그림 9-60). 


요 



그림 9-60. 정합작업 

Eclipse 에서의 가지정 합은 몇개의 가지를 현재의 작업공간에 정 합하여 보관하는 방 
법이다. 

① 작업 공간은 정 합하기 전(이 례의 경우 HEAD) 으로 절환한다. 

[Package Explorer] 보기에서 프로젝트를 오른쪽찰칵하여 현시 되는 내부차림표에서 
[Replace with] — [Another Branch or Version] 을 선택 한다. 

② [Replace with Branch or Version ] 대화칸이 나타난다. 

[HEAD] 를 선택 하여 [OK] 단추를 찰칵한다(그림 9-61). 
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전 CVS Repositories ^ CVS Annotate | ■• c C> 々 > |lEl| 혈 ▼【] 日 ’ 

▽ Q : pservercvsuser01@172.29.92.105:/cvsrep 

> 요 HEAD 

> 卞方 Branches 

> 1 철 Versions 
[#〉 Dates 


그림 9-61. 절환하려는 가지를 선택 


③ 정 합을 시 작한다. 

[Package Explorer ] 보기에서 [SampleChap 기을 오른쪽찰칵하고 [ Team ] — 
[ Merge ] 을 선택한다. 그러 면 [Select the merge start point ] 대 화칸이 현시 되 는데 가 
지 를 만든 경 우에 줄기 에 붙은 판본인 [ Root_BranchO 1] 을 선택 하고 [ Next ] 단추를 찰 
칵한다(그림 9-62). 



그림 9-62. 정합의 시작점을 선택 

④ 다음에 정합하려는 가지를 선택한다. 이 실례에서는 [ BranchOl ] 을 선택한다 
(그림 9-63). 
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■던 臣] 


Select where you want to merge the changes from 

This is the version or branch that contains the work you would like to merge. 




tHEAD 
1 혈 BASE 
▽ ^Branches 

(#> Dates 
I> ^Versions 


< Back | | | finish 一 ! | Cancel 


그림 9-63. 정합한 가지의 선택 

[ Finish ] 단추를 찰칵하면 정 합원 ( BranchOl ) 과 정 합선 ( HEAD ) 의 비 교작업 이 진행 
되고 결과가 나타난다. [ Synchronize ] 보기의 [ ROT 13 En ⑴ der . java ] 를 두번 찰칵한다 
(그림 9-64). 
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그림 9-64. 비교결과 
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⑤ [ Synchronize ] 보기에서 [ SampleChap 기을 오른쪽찰칵하여 내부차림표로부터 
[ Refresh ] 을 선택 하면 가지 의 내 용이 작업 공간에서 정 합된다. [ Synchronize ] 보기 가 
그림 9-65 와 같이 되면 정 합은 끝난다. 


£3 W 

° 因 

CVS Merg( 

fi 3 - ^ | 

e Koot—Branch 

I 0 0 0 

01 的 

考 

> EranchOr (/SampleChap?) ▼ 


No changes in 'CVS Merge ’Root—Branch01 to BranchOl 1 (/ 
Sampled hap 7)' 


그림 9-65. 정합의 완료 

⑥ 반드시 작업 공간에 변경 이 있기때 문에 보관을 진행한다. 
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제10장. Web 응용프로그람의 개발 

제1절. 개요 

10.1.1. 끼워넣기 ( plugin ) 를 리용한 Web 응용프로그람봉사기와의 련동 

Eclipse 는 끼워넣기에 의해 기능을 확장할수 있으며 이미 많은 끼워넣기가 제공되 
여있다. 

이 장에서는 Web 응용프로그람봉사기와 련동을 진행하는 끼워넣기를 도입하고 Web 응 
용프로그람의 개발，실행 및 오유수정을 진행하는 방법에 대하여 소개한다. Web 응용프로 
그람봉사기로서 Jakarta 프로젝트의 Tomcat 를 리용한다. 또한 Tomcat 와 련동을 진행하 
는 끼워넣기로서 Lomboz 를 리용한다. 


10.1.2. Lomboz 

Lomboz 란 Eclipse 상에서 J 2 EE 응용프로그람개 발을 지원하는 끼워 넣기 이 다. 응용 
프로그람의 개발，배치，응용프로그람봉사기의 련동，시험，오유수정，정지라고 하는 일 
련의 개 발공정 을 Eclipse 상에 서 진행할수 있 다. 

지원하는 응용프로그람봉사기로서 Tomcat , JBoss , WebLogic 등을 들수 있다. 
JSP 의 코드형 식 에 따르는 색 표시，코드편집방조기 기 능을 갖춘 JSP 편집 기 도 제 공해 놓 
고 EJB 개 발지원기능도 갖추고있다. 

o Lomboz 의 주요한 기능 

• 응용프로그람봉사기 ( Tomcat , JBoss , WebLogic 등)의 기동，정지 

• Web 응용프로그람 ( HTML , Servlet , JSP ) 개발지원 

• J 2 EE Web 응용프로그람압축형 식 ( Ear / War) ， EJB 압축형 식 ( Jar ) 작성 과 배 치 (Ant 
를 리용) 

• 응용프로그람봉사기와 련동하는 봉사기측코드 ( JSP , Servlet , EJB ) 의 오유수정 

• JSP 코드형 식 에 따르는 색표시，코드편집방조기，문법 검 사 

• EJB 1.1, 2. 0 ( Session , Entity , Message Driven Bean ) 의 개 발지 원 (XDoclet 
를 리용) 

• EJB 시험말단기의 생성 

• Web 봉사기 말단기 의 생 성 (Applet Axis 를 리 용) 
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제2절. 설치와 설정 

10.2.1. Tomcat 의 설치와 설정 

1. Tomcat 의 입수 

이 장에 서 는 Jakarta Tomcat 5. 0.28 을 전제 로 하여 서 술한다. 

여기서는 이 파일을 리용하여 진행하는 설치를 보기로 한다. Tomcat 의 최신판은 
《 http :// jakarta . apache . org / tomcat / index . html 》로부터 내 리 적재 할수 있다. 


2. 설치와 설정 

Jakarta tomcat 5. 0.28. zip 를 리용하여 Tomcat 의 설치를 진행한다. 

Jakarta tomcat 5. 0. 28. zip 를 적 당한 장소에 풀면 Jakarta tomcat 5. 0. 28이 라는 등 
륵부가 생긴다. 풀기가 끝나면 등록부이름을 Tomcat 로 변경시켜준다. 이렇게 설치를 
완료한다. 설치 후 Tomcat 가 참조하는 환경 변수를 설정 한다. 《 CATALINA_HOME = 
/ kut / Tomcat ) 라고 설 정 한다. 

3. 기동의 확인 

다음으로 Tomcat 의 기동에 대하여 확인한다. 

열 람기 상에서 우에서 서 술한 CATALINA _ HOME 에서 설정한 등록부아래 의 bin 등 
륵부안에 있는 startup , sh 를 두번 찰칵하여 기동한다. 

조종탁으로부터 아래 와 같이 실 행한다. 

sh startup , sh 또는 . startup 

여기에서는 JDK 1.6.0 과 환경변수 JAVA _ HOME 이 이미 설정되였있다는것을 전제 
로 하고있 다. 설정 되 여 있지 않는 경 우 CATALINA _ HOME 을 설정 한것과 같은 방법 으 
로 JAVA _ HOME 으로서 《/ usr / java / jdkl .6.0》 을 설정한다. 그림 10-1 과 같은 화면 
이 현시되고 Tomcat 가 기동한다. 



그림 10-1. Tomcat 의 기동화면 
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열 람기 를 기동하고 « http : // localhost :8080 » 으로 접 근조종한다. 그림 10_2와 같 
은 화면이 현시되면 성공한것 이다. 
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그림 10-2. Tomcat 의 화면 

이렇게 기동에 대한 확인을 한다. 

Tomcat 를 정지시킨다. 파일열람기로부터 《 / kut / Tomcat / bin 》등록부에 있는 
shutdown , sh 를 두번 찰칵하면 정지된다. 조종탁으로부터 아래 와 같이 실행할수 있다. 
sh shutdown , sh 또는 . shutdown 

10.2.2. Lomboz 의 설치와 설정 

1. Lomboz 의 입수 

여 기서 는 Lomboz 3.0.1 을 전제 로 하여 서 술하였 다. 그리 고 Lomboz 의 최 신판은 
《 h 竹 p :// www . objectlearn . com / 》 로부터 내리적재 할수 있다. 

Lomboz 3.0 을 리용할 때에는 eclipse EMF 실행시간용 2.0 이상의 판본도 설치할 필요가 있다. 
EMF 실행시간의 최신판은 《 http : // download , eclipse , oml tools / emf / scripts / downloads , php 》 
로부터 입수할수 있다. 

2. 설치 

Lomboz . 301. zip 를 리용하여 Lomboz 의 설치를 진행 한다. 여 기 에서 언급하는 zip 
형식의 파일을 적당한 장소에 풀어놓으면 plugins 등록부가 생긴다. 풀기가 끝나면 
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plugins 등록부안의 전체 파일을 / kut/eclipse 의 plugins 등록부안에 배 치한다. 이 상으 
로 설치는 완료된다. 


Lomboz 3. 0. 1과 Tomcat 5. 0. 28을 조합시켜 리용하는데서 주의할 점 

Lomboz 3. 0.1 과 Tomcat 5. 0.28 을 조합시 키 면 Eclipse 에 서 는 Tomcat 가 기 
동할 때 례 외 ( java . lang . NullPointerException ) 가 발생 하고 정 확히 기 동하지 
않는다. 이것은 Tomcat 에 부속되여 있는 commons - logging - api . jar 의 판본이 
Tomcat 5.0.27 에서 1.0. 3으로부터 1.0. 4로 변경되였기때문이다. 이 문제는 아래 
에 서술한 두가지 방법중의 하나를 적용하는것으로 풀수 있다. 

1. commons - logging - api.jar 의 판본을 1.0. 3으로 바꾼다. 
commons - logging - api . jar (판본 1 . 0. 3) 을 

\ Companero - l . 2\ jakarta - tomcat _5. 0.28 \bin 에 복사한다. 

2. Tomcat 기동할 때의 인수 (- Djava . endorsed . dirs ) 로부터 
《 ${ serverRootDirectory }/ bin 》 을 소거 한다. 

Lomboz 의 Tomcat 5.0 .x 용 봉사기설정파일 (\ KUT \ eclipse \ plugins \ 
com . objectlearn . jdt . j 2 ee _3. 0. I \ server \ tomcat 50 x . server ) 을 편집 기 로 열 고 
인수 (- Djava . endorsed , dirs ) 로부터 《 ${ serverRootDirectory }/ bin 》을 소거 한 
다. (Tomcat 의 기동과 완료의 설정부분을 설정 할 필요가 있다. ) 


3. 설정 

Eclipse 를 기 동하고 아래 와 같이 설 정한다. 

[ Java ] 투시가 열려져있지 않는 경우 차림표띠로부터 [ Window ] ᅳ [Open 
Perspective ] —[ Java ] 를 선택하고 [ Java ] 투시를 연다. 다음 차림표띠로부터 
[ Window ] ^ [Customize Perspective ] 를 선택 하면 현시 되 는 대 화칸에 서 [ Shortcuts ] 
태 브를 선택 한다. [ Submenus ] 에 서 [ New ] 을 선택 하고 [Shortcuts Categories ] 에 서 
[ Java ] — [Lomboz J 2 EE Wizards ] 를 선택한다(그림 10-3). 득같이 [ Submenus ] 에서 
[Show View ] 를 선택하고 [Shortcuts Categories ] 에서 [Lomboz J 2 EE ] 를 선택한다. 

다음에 [ Commands ] 래 브를 선택하고 [Available command groups ] 에 서 
[Lomboz Actions ] 를 선택한 다음 [ OK ] 단추를 찰칵한다. 
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® Package 
0f Class 
Of Interface 
£5 Source Folder 
Visual Class 


| 픽，象 Ant 然 


S ^1 Refactoring [build] 


j Lomboz SOAP Client wizard 
d 分 Lomboz J2EE Project 
Lomboz J2EE Module 
d Lomboz EAR Module 
뇨 Lomboz EJB Creation Wizard 
Lomboz JSP Wizard 
Lomboz HTML Wizard 
i 衣 Lombo2 Servlet Wizard 
^ Lomboz Filter Wizard 
■獻 Lomboz EJB Test Client Wizard 
-omboz EJB Method Wizard 




1 


•등록된 내용미 표시된다. 


Customize Perspective 


Shortcuts [Commands 

Select the shortcuts that you want to see added as cascade items to the following submenus. The 
selections made will only affect the current perspective (Java). 



Subme 

nus: 

Shortcuts: 


New 륻 - 

서 태 

New 

因 

Shortcut 

Description 

—l 

Shortci 

it Categories: 

Lomboz EAR Module 

Creates a new ear moc 

Lomboz 

J2EE 

□ CVS 

□ Eclipse Modeling Frame\ 

□ Example EMF Model Crc 
▽ H Java 

□ Java Run/Debug 

□ JUnit 

0(0 Lomboz EJB Creation Wizard 

0 만 Lomboz EJB Method Wizard 

Lomboz EJB Test Client Wizard 

0 ^ Lomboz Filter Wizard 
因 ' 1 ， 1 Lomboz HTML Wizard 

013 承 Lomboz J2EE Module 

A wizard that creates i 

A wizard that creates E 

A wizard that creates i 

A wizard that creates i 

A wizard that creates £ 

Creates a new module 

Wizard 름 - 

m 


0(^ Lomboz J2EE Project 

Creates a new J2EE p 


선덕 

□ Java Emitter Templates 

□ Simple 

0 설 Lomboz JSP Wizard 

0 ^ Lomboz Servlet Wizard 

0O Lomboz SOAP Client wizard 

A wizard that creates i 

A wizard that creates i 

Generate SOAP client 


M 

一 1 四 1 

<1 1 

M 


OK Cancel 


그림 10-3. 투시의 전용화대화칸 

그림 10-4 와 같이 차림 표띠 로부터 [ File ] ᅳ [ New ] 를 선택하면 현시 되 는 부분차림 표 
에서 Lomboz 관련의 항목이 등록되 여있는가를 확인한다. 


E3 Java - Eclipse Platform 

- 品 s 

File Edit Navigate Search Project Run Window Help 

New Alt+Shift-HSI ■ Project... 

5! % J 3ava [신 Resource 


^ Example... 


「3 Other... 


그림 10-4. 등록내용의 확인 
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Close All 

Ctrl+Shift+F4 

段 1 Save 

Qrl+S 

Save As... 


■1 Save All 

Ctrl+Shift+S 

Revert 


Move... 


Rename... 

F2 

Refresh 

F5 

Print... 

Ctrl+P 

Switch Workspace... 


Open External File... 


Import... 


【스 Export... 



Properties Alt+Enter 


1 AbstractStrIngEncoder.java [SampleC...] 

2 EncoderMain.java [SampleChap7/src/...] 

3 MaFrame.java [Java_tmp/src] 

4 room2.gif [kkk/src/image] 


tTer 
JuniFoldFile 

隱? _ 0 
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다음 차림 표띠 로부터 [ Window ] ᅳ [ Preferences ] 을 선택 하고 [ Preferences ] 대 화 
칸을 연다. 대화칸왼쪽의 [ Workbench ] [Label Decorations ] 을 선택한 다음 
[Available label decorations ] 의 [Lomboz J 2 EE Decorators ] 를 선택 한다(그림 10—5). 


1，1 



Labtl D^Korjili- 
UM dapmoiai, vl 
Select vriich a4dbQr 

pcvs 

kUjnLidl 




OtirdUram Ldmbo£ AdmwnLs 


: .1 

，一 IT) 






3L 


그림 10-5. 표시장식설정대화칸 

같은 방법으로 [ Preferences ] 대화칸에서 [ Java ] —[ Buildpath ] 를 선택하고 프로젝 
트가 기정 으로 사용하는 건립 경 로를 지정한다. 여 기서는 [ Folders ] 를 선택한다. 
[Source folder name ] 이 《 src》 ， [Output folder name ] 이 《 bin 》 으로 되 여 있는가 
를 확인한다(그림 10-6). 



그림 10-6. 건립경로설정대화칸 
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대화칸왼쪽의 [ Lomtoz ] 를 선택하고 [JDK T ⑴ Is . jar ] 의 경로를 설정한다. 여기서는 
JDK 1.6.0 이 《 / usr / java / jdkl . 6.0》또는《 / Companero -1.2/ jdkl .6.0》 에 설치되였기때문 
에 (/ usr / java / jdkl .6.0/ lib / tools . jar } 또는 ( / Companero -1.2 / jdkl .6.0/ lib / tools . jar > 
를 설정한다(그림 10-7). 



그림 10-7. Lomboz 설정대화칸 

[ Lomboz ] 구 [Server Definitions ] 를 선택 하여 응용프로그람봉사기 에 대 한 설정 을 
진행한다. 이 장에서 는 Tomcat 5.0.28 을 사용하기 때 문에 [Server Types ] 에 
(Apache Tomcat v 5.0. x 》 를 선택하고 [ Properties ] 태브에서 [Application Server 
Directory ] 및 [Classpath Variable ] 에 《/ Companero -1.2/ jakarta - tomcat —5. 0. 28》 
을 설정 한 다음 [ Apply ] 단추를 찰칵한다(그림 10-8). 

[ Java] ^ [Build Path ] —[Classpath Variables ] 를 선택하고 그림 10-9 와 같이 
Tomcat 에 대 한 클라스경 로변수가 설정 되 여있는가를 확인한다. 다음 [ OK ] 단추를 찰칵 
하여 [ Preferences ] 대화칸을 닫는다. 이상으로 Lomboz 의 설정은 끝난다. 
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그림 10-8. 봉사기설정대화칸 




그림 10-9. 클라스경로변수설정 대화칸 
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제3절. Web 응용프로그람작성과 실행 

10.3.1. Web 응용프로그람작성 

종업원검색에 대한 간단한 응용프로그람을 작성함으로서 Eclipse 상에서의 Web 응용 
프로그람개 발에 대 하여 학습한다. 여 기 에서 작성 하는 종업 원검 색 응용프로그람은 JSP , 
Servlet 및 검색엔진을 가전 Java 클라스를 탑제하는것으로 처리를 진행한다(그림 10-10). 

이 처 리모델을 MVC 모델이라고 부론다. MVC 모델은 응용프로그람을 업무론리를 가 
지는 Model , 표시론리를 가지는 View , 그리고 Model 과 View 를 조종하는 
Controller 의 3가지로 구성되는 형태로서 Model 과 View 를 명확히 분리시키고 응용프 
로그람설계의 유연성，재리용성을 향상시킬수 있다. 즉 JSP , Servlet 를 기초로 한 
Web 응용프로그람에서는 JSP 가 View , Servlet 가 Controller 의 역할을 담당한다. 


Controller 



그림 10-10. 종업원검색 응용프로그람의 처리방식 


표 10-1 에 종업원검색응용프로그람의 각 구성요소의 개요를 그림 10-11 에는 종업 
원검색 응용프로그람의 화면이 행 에 대 하여 보여주었 다. 
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표 10 - 1 . 

종업원 검색 응용프로그람의 구성요소들 

명 칭 

형 식 

개 요 

종업원검색화면 

HTML 

종업원검색의 열쇠어로 되는 종업원번호의 입력폼 
을 가진 화면이다. 종업원번호를 입력하여 종업원 
검색 Servlet 에 검색요구를 준다. 

종업원검색 Servlet 

Servlet 

종업원검색화면에서 보낸 종업원번호의 값을 읽어 
들이고 종업원검색클라스에 검색을 의뢰한다. 또 
한 검색결과에 따라 종업원검색결과화면 또는 종 
업 원검색 오유화면으로 결과를 보낸다. 

종업원검색클라스 

Java 클라스 

넘겨받은 종업원번호를 리용하여 종업원목록 
(XML) 으로부터 종업 원검 색 을 진행한다. 

검색자료클라스 

Java 클라스 

종업 원검 색 Servlet, 종업 원검 색 클라스，종업 원 
검색결과 및 종업원검색오유화면에로 보내는 자료 
포함기 

종업원검색결과 화면 

JSP 

종업 원검 색 클라스로부터 자료를 받아 종업 원정 보 
를 현시한다. 

종업원검색오유 화면 

JSP 

종업 원검 색 클라스로부터 오유를 받아 오유정 보를 
현시 한다. 


종업원3색화면 



5대 (£) 532<& 보기0必 바臣가기© stiTuld) £구 <D Eg 말® 
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대조하려는 종업원번호름 입력하십시 모. 

종업원번호 (l ： ； 

班쑈里 I 


종2원3색걸과화면 


2 색실 IH 


，냥 


종2원3색모유화면 
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종업원검색결과화면 

종2원번호 1 

종업원이름 김철혁 

주 소 평양시 형제산구역 상당동 37반 3호 

종 2 원검색모유 

대조하려는 종 2 원정보가 없습니다. 

완료32白니다. 

| I agaaoua _| 


그림 10 - 11 . 종업원검색응용프로그람의 화면이 행 
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10.3.2. 프로젝트의 작성 

먼저 종업 원검 색 응용프로그람개 발을 위 한 프로젝 트를 작성 한다. 

Eclipse 상의 차림 표띠 로부터 [ File ] ᅳ [ New ] ᅳ [Lomboz J 2 EE Project ] 를 선택하 
고 프로젝트작성조수대화칸을 연다(그림 10-12). 



Project settings 

Project settings 




Next > 


Brash 


그림 10-12. 프로젝 트작성 조수대 화칸 

[Project name ] 에 《 SampleChaplO 》을 입력하고 [Project contents ] 는 기정대 
로 설정 한 다음 [ Next ] 를 찰칵한다. 그러 면 [Java Settings ] 대 화칸이 현시 된다. 
[ Source ] 래 브에서 [Source folder on build path ] 에는 《 SampleChaplO / src 》 등록 
부가， [Default output folder ] 에는 《 SampleChaplO / bin 》 등록부가 설정되여있는가 
를 확인한다(그림 10-13). [ Next ] 를 찰칵한다. 



276 


그림 10-13. Java 설정대화칸 
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[Create J 2 EE Module ] 대 화칸의 [Web Modules ] 태 브에 서 [ Add ] 단추를 리 용하여 
모둘이름을 《 SimpleWeb 》 으로 등록한다(그림 10-14). 



그림 10-14. J 2 EE 모듈작성대화칸 


[Targeted Servers ] 태 브를 선택하여 봉사기의 설정 확인을 진행한다. 여 기서는 
Tomcat 5.0.28 을 리용하므로 [ Type ] 에서 《Apache Tomcat v 5.0. x 》 를 선택하고 
[ Add ] 를 찰칵한다. [Targeted Servers ] 로서 Tomcat 가 등록되기때문에 [ Finish ] 를 
찰칵한다(그림 10-15). 



Creal € J 2 EEModute 


Base folder ]_| | CHflese. ,- 


■豆 因 


AfhJEhr tamrLJl 네 D a_f^~j | 빼 --| 


tomcaip 5BEPCI 
Remcwe | j | 

L^dajce bjuA budd properties for deFajuk saver kl 



그림 10-15. Targeted Servers 태브를 늘렸을 때 현시되는 대화칸 


이것으로서 프로젝트의 작성은 완료된다. [Package Explorer ] 보기에서 SampleChaplO 
프로젝트가 등록되였는가를 확인한다(그림 10-16). 
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그림 10-16. 작성된 SampleChapIO 프로젝트 


10.3.3. 종업 원검 색 화면 ( HTML ) 의 작성 

프로젝트가 작성되였으므로 종업원검색응용프로그람의 개발을 시작해본다. 처음에 
종업 원검 색 용화면 ( index , html ) 을 작성 한다. [ Navigator ] 보기 또는 [Package 
Explorer ] 보기 상에 서 [ SampleChapIO ] —우 [ SimpleWeb ] 를 오른쪽찰칵하고 [ New ] — 
[Lomboz HTML Wizard ] 를 선택하여 HTML 작성대화칸을 연다. [File name ] 에 
《 index . html 》이라고 입력하고 [ Finish ] 를 찰칵한다(그림 10-17). 



臣西 

Create a new HTML file 

<htm!> 

Enter or select the parent folder: 


SampleChaplO/SimpleWeb 

1 


衡 參 대> 

▽ 년 SampleChapIO 


툐 bin 
러 2src 

> 錄 SimpleWeb (WEB) 
i^src 


File name: index.html - index.html 이라고 입력 

Advanced » 


Finish 
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그림 10-17. HTML 작성대화칸 
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[Navigator] 보기 가 현시 되 여 있지 않는 경 우에 는 차림 표띠 로부터 [Window] ᅳ 
[Show View]— [ Navigator] 를 선택하면 현시된다 . Index.html 이 작성되면 편집기가 
현시되는데 여기 에 목록 10-1 과 같은 코드를 입 력한다 . 여기서 굵은 글자로 되 여있는 
부분은 추가 또는 수정한 코드이다 . [ 종업원검색화면]에서는 [ 검색결과]단추를 찰칵하면 종업원번 
호 (memberld) 를 파라메터로 하여 종업원검색 Servlet(/SimpleWeb/MemberSearchServlet) 가 
기 동하도록 설 정한다 . 


목록 10-1. 종업원검색화면 ( index ， html ) 

<!DOCTYPE HTML PUBLIC M -//w3c//dtd html 4.0 transitional//en ? '> 
<meta http-equiv= M Content-Type M content=’’text/html; charset=UTF_8”> 
<html> 

<head> 

〈 title 〉 종업 원검 색 </title> 

</head> 

<body bgcolor=’’#FFFFFF ”〉 

<div align= M center M > 

<h3> 검색하려는 종업원번호를 입력한다 . </h3> 

<form name=”MemberSearchForm n method=”post” 

action= ,, /SimpleWeb/MemberSearchServlet ,, > 

<table width=’’300 n cellpadding=10 align=’’center’’> 

<tr> 

<td width-'40%" bgcolor=”lightblue”〉<div align=”center”> 종업원번호 
</div></td> 

<td width=”60%’’ bgcolor=”palegoldenrod’’〉<input type=”text” 
name= M memberld "></td> 

</tr> 

〈 /table 〉 

<br> 

〈input type= "submit” name=’’submit” value=” 검 색 진행 ”〉 

</form> 

</div> 

</body> 

</html> 


작성 한 index, html 파일 을 열 람기 상에 서 실 행 하면 그림 10-18 과 같이 현시 된 다 . 
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그림 10-18. 종업원검색화면 

10.3.4. 종업원검색 Servlet 의 작성 

종업 원검색 Servlet(MemberSearchServlet.java) 를 작성 한다 . [Navigator] 보기상에 
서 [SampleChaplO] —[src] 를 오른쪽찰칵하고 [New (새로 작성 )] — [Lomboz Servlet 
Wizard] 를 선택하여 대 화칸을 현시한다 . 여 기 에서 [Package] 에 《 sample, web 》 
를， [Name] 에 는《 MemberSearchServlet 》를 입 력 한다 . [Modifiers] 에서 [public] 를 
선택하고 [Superclass] 에 《 java.servlet.http.HttpServlet 》라고 설정하며 
[Which method stubs would you like to create?] 에서 [doPostO] 를 선택한 다음 
[Next] 를 찰칵한다(그림 10-19). 
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그림 10-19. Servlet 작성대화칸 
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그러면 배치서술자설정 대화칸이 현시 되는데 여기서 [Web module] 에는 
( SimpleWeb) ， [Servlet Name] 에 《 MemberSearchServlet 》， [Mapping URL] 
에 《 /MemberSearchServlet /*》 를 설정한 다음 [Finish] 를 찰칵한다(그림 10-20). 



그림 10-20. 배치서술대화칸 

우와 같은 설정을 진행하면 http ： //localhost ： 8080/ SimpleWeb/MemberSearchServlet 
로 종업원검색 Servlet 가 기동되도록 배치서술자 (web.xml) 의 설정이 자동적으로 추가 
된 다 . (상세 한것 은 후에 서 술한다 . ) 

MemberSearchServlet.java 가 작성되여 편집기에 현시되는데 여기에 목록 10-2 
와 같은 코드를 입 력한다.(굵은 문자로 되 여있는 부분은 추가 또는 수정한 코드이 다 . ) 
종업원검색 servlet 에서는 먼저 요청 (request) 으로부터 얻어진 종업원번호 (memberld) 
를 가지 고 종업 원검색클라스 (MemberSearch) 에 검색을 의뢰 한다 . 검색 이 성공(값 1 을 
귀환 ) 이면 종업 원검색결과화면 (/memberSearchOK. jsp) 이 현시되 고 검색 이 실패 (검색 
결과가 없거 나 례 외 가 발생 ) 하면 종업 원검 색 오유화면 (/memberSearchNG.jsp) 이 현시 
된다 . 이 시점에서는 [ 종업원검색클라스]작성이 완료되지 않았으므로 번역시 오유가 발 
생한다 . 다음과 같이 작성하면 된다 . 
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목록 10-2. ggj^ja^iServlet(MemberSearchServlet.iava) _ 

/* 

* Created on May 25， 2005 

* 

* To change the template for this generated file go to 

* Window - Preferences - Java - Code Generation - Code and Comments 
*/ 

package simple.web ； 

import java. io. IOException ； 
import javax. servlet. ServletException : 
import javax. servlet, http. HttpServlet ； 
import javax. servlet, http. HttpServletRequest ； 
import javax. servlet. http.HttpServletResponse ； 

* Qauthor Administrator 

* 

* To change the template for this generated type comment go to 

* Window - Preferences - Java - Code Generation - Code and Comments 
*/ 

public class MemberSearchServlet extends HttpServlet { 

private static final String ngPage = VmemberSearchNG. jsp" : 
private static final String okPage = VmemberSearchOK. jsp" ； 

protected void doPost (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 

String resultPage ； 

MemberDataHolder mdh = new MemberDataHolderO : 
mdh. setld (request. get Parameter (’’ memberld ; 

if (MemberSearch. search (mdh) == 1) { 
resultPage = okPage ； 

} 

else { 

resultPage = ngPage ； 


request, set Attribute ( M mdh M , mdh) ； 
javax. servlet. RequestDispatcher dispatch = 

request. getRequestDispatcher(resultPage) ； 
dispatch, forward (request, response) ； 
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다음에 배 치서 술자 (web.xml) 의 확인 및 편집 을 진행 한다 . [Navigator] 보기상에서 
[SampleChaplO] — [SimpleWeb] — [WEB-INF] — [web. xml] 을 선택 하여 web. xml 파일 
을 현시 한다 . 이 파일에 http :// localhost :8080/ SimpleWeb/MemberSearchServlet^- 
실행하여 종업원검색 Servlet 를 기동하기 위한 아래와 같은 코드가 있는가를 확인해본다 . 
〈 servlet 〉 

<servlet-name>MemberSearchServlet</servlet-name> 
<servlet-class>simple. web. MemberSearchServlet</servlet-class 〉 

</servlet> 

<servlet-mapping> 

<servlet-name>MemberSearchServlet</servlet-name> 
<url-pattern>/MemberSearchServlet/*</url-pattern> 

</servlet-mapping 〉 

즉 이 web.xml 파일에는 welcome-file-list 및 error-page 가 더 정의되여있 
다 . (Lomboz 프로젝트의 작성시에 자동적으로 정의된다 .) 이 책의 종업원검색응용프로그 
람에서 는 리 용할수 없기때 문에 소거한다 . 

목록 10_3 은 편집후의 web. xml 파일 이다 . 

목록 10-3. 배치서술자 (web.xml) _ 

<?xml version=”l. 0” ?> 

<!DOCTYPE web-app PUBLIC ’’-//Sun Microsystems, 

Inc.//DTD Web Application 2.3//EN" 

’’http : / / java. sun. com/dtd/web_app_2_3. dtd ”〉 

<! — Copyright (c) 2002 by ObjectLearn. All Rights Reserved. —> 


<web-app> 

<!— Remove the comments below to define a servlet. —> 

<j-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ --> 

<!— <servlet> — > 

<! — <servlet-name>MyServlet</servlet-name> — > 

<! — <servlet-class>examples. MyServlet</servlet-class> —> 

<!— <init-param> — > 

<! — <param-name>myparam</param-name> — > 

<!— <param-value>12345</param-value 〉 一 > 

<! — </init-param> — > 

<!— </servlet> — > 

<!-- —> 

<!-- —> 

<!— <servlet-mapping> ― > 

<! — <servlet-name>MyServlet</servlet-name 〉 一 > 

<! — <url-pattern>/mine/*</url-pattern 〉 一 > 

<!— </servlet-mapping> — > 

<j-- +++++++++++++++++++++++++++++++++++++++++++++++++++++++ —— > 
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<servlet> 

<servlet-name>MemberSearchServlet</servlet-name> 
<servlet-class>simple. web. MemberSearchServlet</servlet 
-class 〉 

〈 /servlet 〉 

<servlet-mapping> 

<servlet-name>MemberSearchServlet</servlet-name> 
<url-pattern>/MemberSearchServlet/*</url-pattern 〉 

</servlet-mapping 〉 

</web~app> 


10.3.5. 검 색자료보존용 클라스의 작성 
검 색 자료보존클라스 (MemberDataHoder. java) 를 작성 한다 . 

[Navigator] 보기 에 서 [SampleChaplO] — [src] 를 오른쪽찰칵하고 [New] — 
[Class] 를 선택 하면 Java 클라스작성 조수대 화칸이 현시된다 . 여 기 에서 [Package] 에 
《 sample, web 》 를 입 력 하고 [Name] 에 는 《 MemberDataHoder 》 를 입 력 한다 . 그리 고 
[Modifiers:] 에서 [public] 를 선택 하고 [Superclass] 에는《 java. lang.Object 》 를 설 
정 하며 [Which method stubs would you like to create?] 에 서 는 모든 검 사칸들을 선 
택한 다음 [Finish] 를 찰칵한다(그림 10-21). 



그림 10-21. Java 클라스작성 조수대화칸 
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MemberDataHolder.java 가 작성되고 편집기가 현시되는데 여기에 목록 10-4 와 
같은 코드를 입 력한다 . (굵은 문자로 되 여있는 부분은 추가 또는 수정한 코드이 다 . ) 검 색 
자료보존클라스는 종업원검색 Servlet, 종업원검색 클라스，종업원검색결과 및 종업원검 
색오유화면들에서 취급하는 객체이고 열람기상에 표시하기 위한 종업원정보 (ID ， 이름， 
주소 ) 및 검색결과통보창을 가전다 . Getter 및 Setter 메쏘드 (get< 실체변수이름〉， set< 
실체변수이름〉)는 차림표띠로부터 [Source] ᅳ [Getter 및 Setter 의 생성]을 리용하여 
쉽게 추가할수 있다 . 

목록 10-4. 검색자료보존클라스 (MemberDataHdder.java) _ 

/* 

* Created on Mar 25， 2005 


* To change the template for this generated file go to 

* Window - Preferences - Java - Code Generation - Code and Comments 
*/ 

package simple.web ； 

/** 

* Qauthor Administrator 


* To change the template for this generated type comment go to 

* Window - Preferences - Java - Code Generation - Code and Comments 
*/ 

public class MemberDataHolder { 

private String id ； 

private String name ； 

private String address ； 

private String message ； 

public String getldO { 
return id ； 

} 

public void setld (String id) { 
this, id = id ； 

} 

public String getNameO { 
return name ； 

} 

public void setName (String name) { 
this, name = name ； 
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public String getAddressO { 
return address ； 

} 

public void setAddress (String address) { 
this, address = address ； 

} 

public String getMessageO { 
return name ； 

} 

public void setMessage (String message) { 
this, message = message ； 


10.3.6. 종업원검색클라스의 작성 

종업 원검 색 클라스 (MemberSearch. java) 를 작성 한다 . 검 색 자료보존클라스와 같이 
[Navigator] 보기 상에 서 [SampleChaplO] — [src] 를 오른쪽찰칵하고 [New] — [Class] 
를 선택하면 Java 클라스작성대화칸이 현시된다 . 여기에서 [Package] 에 《 sample.web 》 
를 입 력 하고 [Name] 에 는《 MemberSearch 》를 입 력 한다 . [Modifies] 에 서 [public] 를 
선택 하고 [Superclass] 에《 java. lang.Object 》 를 설정 한 다음 [Which method stubs 
would you like to create ?] 에서 모든 검사칸의 선택를 해제하고 [Finish] 를 찰칵 
한다(그림 10-22). 



Java Class 



⑬ 


Source Folder SampleChaplO/src 

Package: sample.web - sample.web 라고 입력 

□ Enclosing type: 


Name: 

MemberSearch 

- MemberSearch 라고 입력 

Modifiers: 

(§) public 

O default O O 


□ abstract 

□ final □ 

Superclass: 

|java.lang.Object 11 Brows 至 … 

interfaces: 

Add... 

L 




Which method stubs would you like to create? 

□ public static void main(StringQ args) 

□ Constructors from superclass - 전제 선덕을 Sll 제한다 

□ Inherited abstract methods 
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MemberSearch.java 가 작성되여 편집기에 현시되는데 여기에 목록 10_5 의 코드를 
입 력한다.(굵은 문자로 되 여있는 부분은 추가 또는 수정한 코드이 다 . ) 
MemberSearch.java 에서는 넘어온 종업원번호 (memberld ) 를 가지고 우선 종업원목록 
(member.xml ) 에서 검색 을 진행 한다 . 대 응하는 종업원정보가 있는 경우에는 그 정보 
(종업 원이름，주소)및 검색 이 성공하였다는것을 의미하는 통보문을 검색자료보존클라스 
(mdh ) 에 설정하고 귀환값으로서 1 을 되돌린다 . 또한 입력된 종업원번호에 대응하는 종 
업 원정보가 없을 때 에는 그 내 용을 표현하는 동보문을 검색 자료보존클라스 (mdh ) 에 설 
정하고 -1 을 귀환한다 . 즉 MemberSearch. java 에서는 XML 형식의 종업원목록 
(member, xml) 으로부터 정 보를 검 색 하기 위 하여 Java 에 서 XML 문서 를 처 리 하기 위 한 
API 인 DOM (Document Object Model) 을 리 용하고있 다 . 

목록 10-5. 종업원검색클라스 (MemberSearch.java) 

/* 

* Created on Mar 25， 2005 


* To change the template for this generated file go to 

* Window - Preferences - Java - Code Generation - Code and Comments 
*/ 

package simple.web ； 

import java.io .*； 

import javax.xml.parsers.*; 

import org.w3c.dom .*； 

I%% 

* Qauthor Administrator 


* To change the template for this generated type comment go to 

* Window - Preferences - Java - Code Generation - Code and Comments 
*/ 

public class MemberSearch { 

private static final String filePath = 

’’c : / eclipse/workspace/My T est/SimpleWeb/member, xml”; 
private static final String msglnputError = 

" 종업원 ID 가 입력되지 않았습니다 .’’; 
private static final String msgSearchSuccess = 

’’ 종업원정보 검색이 정확히 끝났습니다 .’’; 
private static final String msgSearchError = ” 종업원정보가 틀립 니 다 . ’’; 
private static final String msgFailure = 

’’ 종업원정보검색에서 장애가 발생했습니다 .’’; 
private static NodeList memberList ； 
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static int search (MemberDataHolder mdh) { 
try { 

if(memberList == null) { 

DocumentBuilderFactory dbFactory = 
DocumentBuilderFactory. newInstanceO ； 

DocumentBuilder builder = dbFactory. newDocumentBuilderO : 
Document doc = builder, parse (new File(filePath)) : 

Element root = doc.getDocumentElementO ； 
memberList = root. getElementsByTagName( M member M ) : 

} 

String id = mdh.getldO : 

if (id == null || id. equals ( M M )) { 

mdh. setMessage(msglnputError) ； 
return -1 ； 

} 

for (int i=0 ； KmemberList.getLengthO : i++) { 

Element element = (Element) memberList. item (i) : 
if (id. equals (element, get Attribute ("id"))) { 

NodeList nameList = element. getElementsByTagNameC'name") : 
Element nameElement = (Element) nameList. item (0) ； 
mdh. setName(nameElement. getFirstChildO. getNodeValueO); 


NodeList addressList = 

element. getElementsByTagName("address") ； 

Element addressElement = (Element) addressList. item(0); 
mdh. setAddress (addressElement. getFirstChildO. 
getNodeValueO); 

mdh. setMessage(msgSearchSuccess) ； 
return 1 ； 


mdh. setMessage(msgFailure) ； 
return -1 ； 

} 

catch (Exception e) { 

mdh. setMessage (msgFailure) ； 
return -1 ； 


다음으로 종업원목록 (member, xml) 을 작성한다 . [Navigator] 보기에서 [SampleChaplO] 
ᅳ [SimpleWeb] 를 선택한 상태 에 서 [New] ᅳ [File] 을 선택하면 파일 작성 대 화칸이 열 
린다 . [File name] 에 《 member.xml 》 을 입 력 하고 [Finish ] 를 찰칵한다(그림 10-23). 


288 


錢變邊 錢變變繼繼繼 








세 to 강. Web 44 ll 그聲의 게•參 


File 

Create a new file resource 



■□Jx] 

Br 


< Back 


finish 


그림 10-23. 파일작성대화칸 

member, xml (파일의 내용은 공백)이 작성되여 편집기에 현시되는데 여기에 목록 
10-6 의 코드를 입력시킨다 . 


목록 10-6. 종업원목록 (member.xml) 

<?xml version=”l. 0” encodings M UTF-8 M ?> 


<memberList> 

<title>Member List</title> 

〈member id= M l M > 

<name > 김 철 혁 </name 〉 

〈 address 〉 평 양시 형제산구역 상당동 37 반 1 층 3 호 〈 /address 〉 
〈 /member 〉 

〈member id= n 2”> 

<name> 리 철 영 </ name 〉 

〈 address 〉 평 양시 락랑구역 승리 1 동 28 반 3 층 3 호 〈 /address 〉 
</member> 

〈member id= n 3”> 

<name > 박옥희 </name 〉 

〈 address 〉 평양시 모란봉구역 전우동 40 반 5 층 1 호 </80 뇨 11 冗 33 〉 
</member> 

</memberList> 
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10.3.7. 종업원검색결과화면 ( JSP ) 의 작성 

종업 원검 색 결과화면 (MemberSearchOK. jsp) 을 작성 한다 . [Navigator] 보기 에 서 
[SampleChaplO] ^ [SimpleWeb] * 오른쪽찰칵하고 [New] — [Lomboz JSP Wizard] 
를 선택하면 JSP 파일작성대화칸이 열린다 . [File name] 에 《 MemberSearchOK 》 라고 
입력하고 [Next] 를 찰칵한다(그림 10-24). 



그림 10-24. JSP 파일작성대화칸 


[Set JSP details] 대화칸에서 [Add] 를 찰칵한다 . [Select Beans] 에서 [I 이에 
《 mdh 》를 입 력 하고 [Scope] 에 서 《 request 》를 선택하며 [Select Class] 에 
《 sample.web.MemberDataHoder 》 를 입력하고 [OK] 를 찰칵한다(그림 10-25). 
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이 리 한 설정 들을 진행하여 JSP 안에서 검 색자료보존클라스 (MemberDataHoder ) 의 
실체인 mdh 를 취급할수 있게 된다 . 다음에 [Set JSP details ] 대화칸의 [Content 
type] 에 서 《 text/html;charset = UTF_8》 ， [Page encoding] 에 서 《 UTF-8 》 을 선 
택한 다음 [Finish] 를 찰칵한다(그림 10-26). 



그림 10-26. JSP 상세설정대화칸 

이렇게 하면 memberSearchOK.jsp 가 작성되고 편집기상에 작성된 코드가 현시된 
다 . 목록 10-7 과 같이 코드를 입 력 한다 . (굵은 문자로 되 여 있는 부분은 추가 또는 수정 
한 코드이 다 .) MemberSearchOK. jsp 에서는 mdh (종업원자료보존클라스의 실체)로부터 
Getter 메쏘드 (get< 실체변수이름〉，례 : getName) 를 리용하여 정보를 얻고 화면에 현시 
하는 처 리 를 진 행 한다 . 

목록 10-7. 종업원검색결과화면 ( memberSearchOKJsp ) 

<%9 page language-"java" pageEncoding- M UTF~8 M %> _ 

<!DOCTYPE HTML PUBLIC M -//w3c//dtd html 4.0 transitional//en M > 
<html> 

<head> 

<title> 종업 원검 색 결과 〈 /title 〉 

</head> 

<body bgcolor: n #FFFFFF’’> 

<jsp：useBean id= n mdh n scope= n request” 

class="simple, web. MemberDataHolder M /> 

<div align=” center” > 

<h3 > 종업 원검색 결 과 </h3> 

<%= mdh. getMessageO %> 
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< table width=’’500” cellpadding=10 align= M center M > 

<tr> 

<td width="20% M bgcolor=”lightblue”> 종업원번호 </td> 

<td width="80% M bgcolor=’’palegoldenrod’’><%=mdh.getId() %></td> 
</tr> 

<tr> 

<td width=’’20%’’ bgcolor=’’lightblue”> 종업원이름 </td> 

<td width= M 80% M bgcolor= M palegoldenrod n ><%=mdh.getName() %></td> 
</tr> 

<tr> 

<td width= M 20% M bgcolor=’’lightblue’’> 주소 </td> 

<td width= M 80% M bgcolor="palegoldenrod"><%= 
mdh. getAddress () %></td> 

</tr> 

</table> 

</div> 

</body> 

</html> 


10.3.8. 종업 원검 색 오유화면 ( JSP ) 의 작성 

종업 원검 색 오유화면 (MemberSearchNG. jsp) 을 작성 한다 . 종업 원검 색 결 과화면과 
득같이 [Navigator] 보기 에 서 [SampleChaplO] — [SimpleWeb] 를 오른쪽찰칵하고 
[New] ᅳ [Lomboz JSP Wizard] 를 선택하면 JSP 파일작성대화칸이 나타난다 . [File 
name] 에 《 memberSearchNG 》 를 입 력 하고 [Next] 를 찰칵한다 . [Set JSP details] 대 화칸 
에서 [Add] 를 찰칵하고 [Select Beans] 대화칸에서 [I 的에 《 mdh 》 를 입력한다 . 그리고 
[Scope] 에서 [request] 를 선택증!•고 [Selectclass] 에 《 sample.v/eb.MemberDataHolder 》 
를 입 력 한 다음 [OK] 를 찰칵한다 . 이 설정 들을 진행하여 JSP 안에 검 색자료보존클라스 
(MemberDataHolder) 의 실체인 mdh 를 취급할수 있게 된다 . 

다음으로 [Set JSP details(JSP 상세설정)]대화칸의 [Content type ( 내용물형태 )] 
에서 《 text/html;charset=UTF-8》 ， [Page encoding ( 폐지부호화)]에서 《 UTF-8 》 
을 선택한 다음 [Finish] 를 찰칵한다 . 

그렇게 하면 memberSearchNG.jsp 가 작성되고 편집기상에 작성된 코드가 현시된 
다 . 목록 10-8 과 같이 코드를 입 력한다 ( 굵은 문자로 되 여있는 부분은 추가 또는 수정 
한 코드이 다 .). MemberSearchNG. jsp 에서는 mdh 로부터 오유통보문정 보를 얻고 화면 
에 현 시 하는 처 리 를 진 행 한다 . 

이 상으로 종업 원검 색응용프로그람의 개 발은 완료된 다 . 
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목록 10-8. 종업원검색오유화면 (memberSearchNG.jsp) 

<%9 page language="java M pageEncoding= "UTF-8 M %〉 

<!DOCTYPE HTML PUBLIC M -//w3c//dtd html 4.0 transitional//en M > 
<html> 

<head> 

〈 title 〉 종업 원검 색 오유 </title> 

</head> 

<body bgcolor: ，， #FFFFFF n > 

<jsp：useBean id= n mdh n scope=”request” 

class=”simple. web. MemberDataHolder" /> 

<div align= "center "〉 

<h3> 종업 원조사오유 </h3> 

<%= mdh. getMessageO %> 

</div> 


</body> 

</html> 


제 4 절. Web 응용프로그람의 실행 

작성한 종업 원검 색응용프로그람을 실행한다 . 그러 기 위 해서 는 Tomcat 를 기동시켜 
응용프로그람을 적재하여 야 한다 . 여 기 에서는 Lomboz 의 기능을 사용하여 종업 원검색응 
용프로그람의 전개 및 Tomcat 의 기 동을 진행하는 방법 을 설명한다 . 또한 응용프로그람 
의 실행 후 Tomcat 의 정지 를 진행 하는 방법 에 대 하여 설명 한다 . 

10.4.1. Web 응용프로그람의 적재 

차림 표띠 로부터 [Window] — [Show view] ^ [Lomboz J2EE View] 를 선택 한다 . 
[Lomboz J2EE View] 가 보이지 않는 경우에는 [Other] 를 선택 하고 [Lomboz J2EE] 

— [Lomboz J2EE View] 를 선택 한다 . Lomboz J2EE View 가 열 리면 [SampleChaplO] 

— [SimpleWeb] 상에서 오른쪽찰칵하고 [Deploy ( 배치)]를 선택한다(그림 10-27). 그 
러면 그림 10-28 과 같은 통보창이 [Console] 보기에 현시되고 War (Web Application 
aRchive) 파일의 작성 및 Tomcat 에로의 적재가 시작된다 . 
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그림 10-27. 종업원검색 응용프로그람의 적재 



그림 10-28. 적재시 조종탁에 현시된 틍보문 

열람기를 기동하고 /kut/Tomcat/webapps 등록부에 SimpleWeb. war 가 배치되였 
는가를 확인한다 . 즉 Lomboz 에서는 War 파일의 작성 및 Tomcat 에로의 적재에 Ant 가 
리 용되 고있 다 . Ant 건 립 파일 (build, xml) 및 속성 파일 (build, properties) 은 Lomboz 에 
의해 자동적 으로 만들어지 고 SampleChaplO\SimpleWeb\WEB-INF 아래 에 배 치되는데 
이것을 확인해본다(목록 10-9 ， 10-10). 물론 [ 제 8 장 Ant 지원]에서 설명한것처럼 

[Navigator] 보기 에 서 build, xml 을 오른쪽찰칵하고 [Run] —[2 Ant build ] 를 선택 한 
후 [deploy ] 과제를 실행 하는 등의 방법 에 의 해 War 파일의 작성 및 Tomcat 의 적재를 
진행할수 있 다 . 
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목록 10-9. Lomboz 에 의해 자동적으로 만들어진 Ant 건립파일 ( build . xml ) 

<!— Copyright (c) 2002 by ObjectLearn. All Rights Reserved. — > 
〈project name="webmodulebuilder M default:’’deploy’’ basedir= n . ”〉 

<! — set global properties for this build —> 

〈property file=’’build. properties"/> 

〈property name=’’dist’’ value= /dist” /> 

〈property name="web n value=”../ n /> 

<target name=’’init”> 

<! — Create the dist directory structure used by compile 
and copy the deployment descriptors into it —〉 

Cmkdir dir=”${dist} ”/〉 

<mkdir dir="${dist}/WEB-INF ’’/〉 

<mkdir dir= M ${dist}/WEB-INF/classesV> 

<mkdir dir= ， ’${dist}/WEB-INF/lib7> 

<copy todir=”${dist} ”〉 

<fileset dir="${web} ,, > 

〈include name = n **/*.*’’/〉 

〈exclude name= M **/jsp_servlet/*. class ’’/〉 

〈exclude name= M **/build.xml M /> 

〈exclude name= n **/deploy.xml M /> 

〈exclude name=’’**/build. properties"/> 

〈exclude name= M **/servers. xm 1 M /> 

〈exclude name="**/targets.xml"/> 

〈exclude name= n **/*. war ’’/〉 

</fileset> 

</copy> 

<copy todir= ” $ {dist}/WEB-INF / classes"> 

<fileset dir=”${project, dir}/${bin. dir} "> 

〈include name = n **/*.*’’/〉 

〈exclude name= "**/jsp_servlet/*. class ’’/〉 

</fileset> 

</copy> 


〈 /target 〉 


<target name=’’deploy’’ depends^"undeploy, init" > 
<! Create the distribution directory —> 

〈delete file= n ${war}.war” failonerror= "false" /> 
<jar jarfile- M ${war}. war M basedir= n ${dist} n /> 
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〈copy file= ? '${war}.war" todir="${deploy.dir }"/〉 
〈delete file= n ${war}.war” failonerror= "false" /> 
〈delete dir=”${dist}” failonerror= "false" /> 
〈 /target 〉 


<target name= "deployTool M > 

<ant antfile=". /deploy.xml" dir=". M target^"deploy" inheritall=’’true’’> 
</ant> 

</target> 


<target name= "undeploy M > 

<!— Sometimes you can undeploy with deleting the module 
file but it is best dealt on an appserver basis 
at undeploy Tool target — 〉 

〈 /target 〉 

<target name="undeployTool M > 

<ant antfile=". / undeploy.xml" dir=".” 
target= "undeploy’’ inheritall=”true’’> 

</ant> 

〈 /target 〉 

</project 〉 


목록 10-10. Lomboz 에 의해 자동적으로 만들어진 속성파일 ( build . properties ) 


#LOMBOZ BUILD FILE PROPERTIES- UPDATED：Sat Mar 26 09:56:49 PST 2005 

#Sat Mar 26 09:56:49 PST 2005 

war=SimpleWeb 

eclipse. home=/c\ : / eclipse/ 

module=SimpleWeb 

adminToolPath= 

project. dir=.. / .. / 

ejbsrc. dir=ejbsrc 

deploy. dir=C\:/jakarta-tomcat-5. 0.28/webapps 
project. path=C\ : WeclipseWworkspaceWMyT estWbin ； C\ ： \\ 
jakarta-tomcat-5. 0.28\\bin\\bootstrap. jar ； C\：\\ 
jakarta-tomcat-5. 0.28\\common\\lib\\servlet-api. jar ； C\：\\ 
jakarta-tomcat-5. 0. 28\\common\\lib\\jsp-api. jar 
bin.dir=bin 
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10.4.2. Tomcat 의 기동 

다음에 Tomcat 를 기동한다 . [Lomboz J2EE View] 를 열고 [SampleChaplO] — 
[SimpleWeb] —[Apache Tomcat v5. 0.x] 상에 서 오른쪽찰칵하고 [Run Server] 를 선 
택한다(그림 10-29). 그림 10-30 과 같은 통보문이 [Console] 보기에 나타나고 Tomcat 
가 기동한다 . 



그림 10-29. Tomcat 의 기동 
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2-005, ft. 11 9:23:51 DTK.B|?Bi:bii.cflli ： ll5]u.!iEi]rlu|P..Ciie.dlili:i AliitL 

■l: Sfrw itimp im 1 • 犯的 ! ，«■ 


그림 10-30. Tomcat 기동할 때 조종탁■보문 

열 람기 를 기동시 키 고 주소칸에 《 http://localhost:8080/SimpleWeb 》 를 입 력 한다 . 
그림 10-31 과 같은 화면이 나타나면 성공이다 . 



그림 10-31. 종업원검색화면 
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즉 Lomboz 에서는 Tomcat 의 기동에 Eclipse 의 기동구성 이 리용되고 있다 . 차림표 
띠 로부터 [Run] —[Run."] 을 선택 하면 [Create, manage and run configurations] 
대화칸이 나타나는데 여기서 [Java Application] —[SampleChapl 0-Apache 
Tomcatv50x] (Lomboz 에 의 해 자동적 으로 설정 된다 . )를 선택 하여 기동구성 의 설정 을 
확인해 본다(그림 10-32). 물론 [Create, manage and run configurations] 대 화칸에 
서 [Run] 를 찰칵하여 Tomcat 를 기동시킬수 있다 . 


Main Tab 
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그림 10-32. Lomboz 에 의해 자동설정된 Tomcat 용 기동구성 
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10.4.3. Web 응용프로그람의 실행 

종업원검색화면의 종업원번호에 《 1 》을 입력하고 [ 검색실행]단추를 찰칵한다(그림 
10-33). 



그림 10-33. 종업원검색화면에 자료입력 

검 색 결과가 종업 원검 색 결과화면에 나타난다(그림 10-34). 



그림 10-34. 종업원검색결과화면 

열람기상의 [Back] 단추를 찰칵하고 다시한번 종업원검색화면을 펼친다 . 이번에는 
《 5 》를 입 력 하고 [ 검색실행]단추를 찰칵한다 . 그러면 그림 10-35 과 같이 종업 원검 색 오 
유화면이 현시된다 . 
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그림 10-35. 종업원검색오유화면 

이상으로 종업원검색응용프로그람의 실행이 확인되였다 . 

10.4.4. Tomcat 의 정지 

Tomcat 를 정지시 키 기 위 하여 [Lomboz J2EE View] 로부터 [SampleChaplO] — 
[SimpleWeb] ^ [Apache Tomcat v5.0.x] 를 선택 한 상태 에 서 오른쪽찰칵하여 [Stop 
Server] 를 선택한다. 그림 10-36 과 같은 통보문이 [Console] 보기 에 나타나고 
Tomcat 가 정지된다. 



그림 10-36. Tomcat 정지시 조종탁의 ■보문 
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제5절. Web 응용프로그람의 오유수정 

Eclipse 및 Lomboz 의 기능에 의 해 Web 응용프로그람의 통합적 인 오유수정 환경 이 
제공된다. 여기서는 Servlet 및 JSP 의 오유수정 방법 에 대하여 설명한다. Servlet 의 오 
유수정 례로서 종업원검색 Servlet ( MemberSearchServlet . java) ， JSP 의 오유수정으로 
서 종업 원검 색 결 과화면 ( memberSearchOK . jsp ) 을 취 급한다. 

10.5.1. 국부적 인 오유수정방법 과 원격 오유수정방법 

Eclipse 및 Lomboz 를 리 용하면 Web 응용프로그람의 국부적 인 오유수정 및 원격 오 
유수정 둘다 가능하다. 

여 기 서 말하는 국부적 인 오유수정 이 란 Eclipse 상에 서 Tomcat 를 기 동 (Eclipse 가 
Tomcat 를 직접조종)하고 오유수정를 하는것을 말한다. Eclipse 가 가동하는 국부콤퓨터 
상에 Tomcat 가 존재 하여 야 한다. 

한편 원격오유수정이란 국부를퓨터상에서 가동하는 Eclipse 로부터 J 2 SE SDK 의 
JPDA(Java Platform Debugger Architecture ) 를 통하여 Eclipse 와는 독립 적 으로(보 
통은 원격 콤퓨터 상에서 ) 기 동되 고있는 Tomcat 에 대 한 접 속，감시 를 진행하는것 으로 오 
유수정를 하는것을 말한다. (이 책에서는 편리상 국부름퓨터상에서 Tomcat 를 기동하고 
다른 콤퓨터 에서 국부콤퓨터 를 지 정하여 접 속을 진행한다. ) 

10.5.2. 종업원검색 Servlet 의 국부적인 오유수정 

종업원 Servlet 를 실례들어 Servlet 의 국부적 인 오유수정에 대하여 설명 한다. 

1. 멈춤점의 설정 

종업 원검 색 servlet 의 MemberSearchServlet 에 멈 춤점 을 설정 한다. 

[ Navigator ] 보기 에 서 MemberSearchServlet . java 를 선택 하여 편집 기 에 그 파일 
을 현시한다. 멈춤점을 설정하려는 행(이 례에서는 31행)의 왼쪽끝에 마우스유표를 이 
동하고 두번 찰칵하든지 아니 면 오른쪽찰칵하여 [Toggle Line Breakpoint ] 에서 설정 한 
다.(그림 10-37) 


21 ^ 


protected void doPost(HttpSeuvletRequest request, 

HttpSeuvletResponse response) throws ServletExceptj 

String resultPage; 

MemberDataHolder mdh = new HembeuDataHolder(); 
mdh. set Id (request. getPauameter ( "member Id ,p ) ) ; 

if (HerribeuSearch.search(mdh) == 1) { 

resultPage = olcPage; 

} else { 

resultPage = ngPage; 

} 



그림 10-37. 럽춤점의 설정 
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2. 오유수정의 실행 

오유수정 을 진행 하기 위하여 Tomcat 를 오유수정방식 으로 기 동시 킨다. [Lomboz 
J 2 EE View ] 보기 에 서 [ SampleChaplO ] ^ [ SimpleWeb ] ^ [Apache Tomcat v 5. 0. x ] 
를 오른쪽찰칵하고 [Debug Server ] 를 선택한다 ([Run Server ] 에서 기동한 경우에는 
한번 [Stop Server ] 로 정지되기때문에 [Debug Server ] 로 재기동한다. 이미 [Debug 
Server ] 로 기동중이라면 재기동할 필요가 없다.). 이때 그림 10-38 과 같은 통보창이 
[ Console (조종탁)]보기상에 현시되고 Tomcat 가 기동한다. 



그림 10-38. Tomcat 가 기동할 때 조종탁틍보문 

열 람기 를 기 동하여 주소칸에《111^: //100요1110아: 8080/와111뀬16광613》를 입 력 하면 종 
업원검색화면이 나타난다. 종업원번호에 《1》을 입력하고 [검색실행]단추를 누른다. 화 
면이 [ Debug ] 투시로 절환되고 멈춤점을 설정한 행에서 실행이 정지된다. 


I [Zl MemberSearchServlet. java 2 之 

因 

27v protected void doPost(HttpServletRequest request. 

/S 

28 

HttpServletResponse response) throws ServletException, IOException { 


29 



30 

String resultPage; 


©31 

HertiiberDataHo lder mdh = new HerriberDataHolder () ; 


32 

mdh. set Id (request. getParameter ( ^merriber Id ,r ) ) ; 


■33 



34 

if (MemberSearch.search(mdh) == 1) { 


35 

resultPage = okPage; 


36 

} else { 


37 

resultPage = ngPage; 


38 

} 

V 

< 


> 

명 Console 然 

Tasks 



〈 terminated〉SampleChap 1 0-ApacheTomcatv50x [Java Application] C:\Program Files\Java\jre 1.6.0\bin\javaw.exe (Sep 7, 2005 9:31:35 AM) 

그림 10-39. [ Debug ] 투시 

[ Debug ] 투시로 절환한 경우는 [Remember my decision ] 를 선택하고 [ Ok ] 를 찰 
칵한다. (이 후부터 이 대 화칸은 표시되지 않는다. ) 

화면왼쪽상의 [ Debug ] 보기 의 도구띠 에 배 치된 단추 또는 [ Run ] 차림 표를 리 용하 
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여 [Step Into ] , [Step Over ], [ Step Return ] 등을 시험해본다. (오유수정의 자세한 
부분은 [제 5장 오유수정 ] 를 참조) [ Debug ] 보기 에 서 [ Resume ] 단추를 누르는 조작에 
의해 마지막까지 처리가 실행되면 열람기에 실행결과가 현시된다. 

이상에서 종업원 Servlet 의 국부적인 오유수정에 대한 설명은 끝난다. 실행결과를 
확인하려 면 [Lomboz J 2 EE View ] 로부터 [ SampleChaplO ] ^ [ SimpleWeb] ^ [Apache 
Tomcat v 5.0. x ] 를 선택한 상태 에 서 오른쪽찰칵하여 [Stop Server ] 를 선택하여 
Tomcat 를 정 지 시킨 다. 

10.5.3. 종업원검색 Servlet 의 원격오유수정 

앞에서와 마찬가지로 종업원검색 Servlet 를 실례들어 Servlet 의 원격오유수정에 대 
하여 설 명한다. 

1. Tomcat 의 기동서술의 편집과 기동 

원격 오유수정 를 진행하는데 는 Tomcat 를 원격 오유수정 기 능을 설 정 하고 기 동시 켜 야 
한다. Tomcat 를 이 미 기동시키 고있었다면 정지 시켜 야 한다. 

(\ Companero - l . 2\ jakarta - tomcat -5. 0. 28\ bin 》안에 startup , sh 라는 기 동서 술파 
일을 별명 ( startup _ debug . sh ) 으로 복사하고 이 파일을 편집기에서 열어 아래와 같이 
한 행을 추가한다. 

Set CATALINA _ OPTS=-Xdebug -Xnoagent - Djava . compiler=NONE 

- Xrunjdwp : transport = dt _ socket , server = y ， 
suspend=n 

작성한 startup _ debug . bat 를 편집 기 상에 서 두번찰칵하여 Tomcat 를 기 동시 킨다. 
그러면 그림 10-40 과 같이 기동화면이 나타난다. 



그림 10-40. 기동화면 

기동화면에 추가된 통보의 머리부에 아래와 같은 행이 있는것을 볼수 있다. 
Listening for transport dt_socket at address ： XXXX 

여기서 XXXX 는 포구번호로서 4 자리의 수자가 입력된다. 후에 리용하기때문에 변 
경시 킨다. 
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Catalina , bat 의 기능항목에 의한 설정 

( \ Companero - l . 2\ jakarta - tomcat -5. 0. 28 \bin > 안의 catalina . sh 기 능을 리 
용하여 아래 와 같은 설정 을 진행한다. 

Startup _ debug . s h 의 마지막에 [call “% EXECUTABLE %” 
start % CMD _ LINE _ ARGS %] 라는 행과 그전에 아래와 같이 대문자로 쓴 내용을 
추가한다. JPDA_ADDRESS 에는 임의의 포구번호를 지정하여 쓸수 있다. 

Set JPDA _ TRANSPORT = dt_socket 
Set JPDA _ ADDRESS =8888 

Call “% EXECUTABLE %” jpda start % CMD _ LINE _ ARGS % 


2. 멈춤점의 설정 

[10.5.2. 종업 원검 색 Servlet 의 국부적 인 오유수정]의 [멈춤점 의 설정] 에서 실시 한 
것과 같은 방법으로 종업원검색 Servlet ( MemberSearchServlet . java ) 에 멈춤점을 설 
정 한다. 

3. 원격오유수정용 기동구성의 설정 

오유수정를 실행 하기 전에 원격 오유수정 용의 기동구성 에 대 한 설정 을 진행 한다. 

Eclipse 상의 차림표띠로부터 [ Run ] —[ Debug ] 에서 [ Create , manage , and run 
⑴ nfigurations ] 대화칸을 열고 대화칸의 왼쪽에서 [Remote Java Application ] 을 선 
택하고 아래 쪽에 있는 [ New ] 를 찰칵한다. 

4. 오유수정의 실행 

열 람기 를 기 동하여 주소칸에 《 http :// localhost :8080/ SimpleWeb > 를 입 력하면 종 
업원검색화면이 나타난다. 종업원번호에 《1》을 입력시킨 다음 [검색실행]단추를 찰칵 
한다. 그러면 Eclipse 의 화면이 [ Debug ] 투시 로 절환되 고 멈 춤점 을 설정한 행 에서 중지 
한다(그림 10-41). 
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그림 10-41. debug 방식으로 Tomcat 기동 
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화면왼쪽상의 [ Debug ] 보기의 도구띠에 배치된 단추를 리용하여 걸음실행을 해본다. 
[ Replay ] 단추를 찰칵하여 마지 막까지 실행 하면 열 람기 에 실행결과가 나타난다. 

이상으로 종업원검색 Servlet 의 원격오유수정에 대한 설명을 끝마친다. 

열 람기 로부터 《 \ Companero - l . 2\ jakarta - tomcat -5. 0. 28 \bin } 등록부에 있는 
shutdown.bat 를 두번찰칵하여 Tomcat 를 중지시킨다. 

10.5.4. 종업 원검 색결과화면 ( JSP ) 의 국부적 인 오유수정 

여기서는 종업원검색결과화면을 실례들어 JSP 의 국부적인 오유수정에 대하여 설명 
한다. 

1. 상래설정파일의 설정과 콜라스파일의 복사 

JSP 의 오유수정 에서는 JSP 파일에 직접 멈춤점 을 설정할수 없다. 

Tomcat 의 JSP 엔진은 Servlet 원천파일을 리용한다. Eclipse 안에서 멈춤점을 설정하 
자면 JSP Servlet 원천파일을 프로젝트에 넣어야 한다. 

우선 Tomcat 에 대한 설정을 진행한다. Tomcat 가 기동되여있다면 정지시킨다. JSP 
Servlet 원천파일을 생성하고 특정한 등록부에 배치하자면 상태설정파일의 설정을 진행해야 한다. 
열 람기 를 기 동증!•고 《 \ Companero - l . 2\ jakarta - tomcat -5. 0 .28\ conf \ Catalina\localhost } 에 
《 SimpleWeb.xml » 이 라는 이 름을 가진 파일 을 새 로 작성 한다. 그리 고 작성 한 
SimpleWeb.xml 파일을 편집기에 불러들여 아래와 같이 서술해놓는다. [ docBase ] 는 문 
맥의 뿌리 등록부를 표시한다. 결국 이 설정 에 의 해 문맥 의 뿌리 등록부가 
《 \ Companero - l . 2\ jakarta - tomcat _5.0.28\ webapp\SimpleWeb } 로부터 
《 \ kut \ workspace \ SampleChaplO \ SimpleWeb 》로 변경된다. 또한 [ workDir ] 는 
JSP Servlet 원천파일 의 생 성장소를 표시한다. 

< Context path = “/ SimpleWeb ” 

docBase = << \ KUT \ workspace \ SampleChaplO \ SimpleWeb ， ^ 
workDir = w \ KUT \ workspace \ SampleChaplO \ j 2 src ， ^ /> 

[ docBase ] 에서 설정 한 《\ kut \ workspace\SampleChapl (八 SimpleWeb 》 등록부아 
래에 있는 《 WEB - INF \ classes 》 에는 종업원검색응용프로그람의 실행에 필요한 클라스 
파일 (MemberDataHo 1 der . class , MemberSearchServlet . class , 

MemberSearch . class ) 들이 존재 하지 않기 때 문에 《 SampleChaplO \ bin 》아래 에 존재 
하는 클라스파일을 복사해놓아야 한다. [ Navigator ] 보기 에서 [ SampleChaplO ] —[ bin ] 
ᅳ [ sample ] 을 선택하고 오른쪽찰칵한 다음 [ Copy ], [ Paste ] 를 리용하여 파일의 복사 
를 진행한다. 
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2. Tomcat 의 기동과 JSP Servlet 의 원천파일의 넣기 

[Lomboz J 2 EE View ] 보기 에 서 [ SampleChaplO ] ^ [ SimpleWeb ] ^ [Apache 
Tomcat v 5.0. x ] 를 오른쪽찰칵하여 [Debug Server ] 를 선택한다. 그러 면 Tomcat 가 
기동한다. 열람기를 기동시켜 《 http :// localhost :8080/ SimpleWeb 》 로 종업원검색화 
면을 열고 [종업원번히에 《1》을 입력한 다음 [검색실행]단추를 찰칵한다. 

그다음 [ Navigator ] 보기에서 [ SampleChaplC )] 을 오른쪽찰칵하고 [ Refresh ] 을 선택한다. 
그러면 [ j 2 src ] 등록부아래에 [ org \ apache \ jsp ] 등록부가 생기고 《 memberSearchOKJsp . java 》 
파일이 나타난다. 즉 작성된 JSP Sevlet 원천파일에 콤파일오유가 발생하지만 오유수정 
에는 지장이 없다. 

아래에서 서술한 [JSP Servlet 원천파일을 취급할 때에 발생 하는 콤파일오유에 대하 
예를 참고한다. 


3. 멈춤점의 설정 

memberSearchOK _ jsp . java 에 멈 춤점 을 설정 한다. 

먼저 [ Navigator ] 보기 상에 서 memberSearchOK _ jsp . java 를 선택 하고 편집 기 를 
연다. 메쏘드안의 적당한 위치에 멈춤점을 설정한다. (이 목록에서는 31행) 편집기의 왼 
쪽끝에서 오른쪽찰칵하고 [Toggle Method Load Breakpoint ] 을 선택한다(그림 
10-42). 
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믿층점# 설정한 
행에서 실행이 
정지된다 


그림 10-42. 멈춤점의 설정 
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4. 오유수정의 실행 

memberSearchOK _ jsp . java 의 오유수정 을 진행 한다. 열 람기 를 기 동하여 
《 http :// localhost :8080/ SimpleWeb 》 으로 종업원검색화면을 열고 [종업원번히이에 
《1》을 지정한 다음 [검색실행]단추를 찰칵한다. 화면이 [ Debug ] 투시 로 절환되 고 멈춤 
점을 설정한 행에서 실행이 정지된다(그림 10-43). 


믿층점믈 설정한 
행에서 실행이 
정지된다 


멈춤점에서 정지가 잘 되지 않는 경우에는 Tomcat 를 일단 끝내고 다시 한번 
Debug Server 로서 기동한다. 화면왼쪽상의 [ Debug ] 보기의 도구띠에 배치된 단추를 
리용하여 단계실행을 진행한다. [ Replay ] 단추를 찰칵하여 마지막까지 처리가 실행되면 
열람기에 실행결과가 현시된다. 

이 상으로 종업 원검 색 결과화면 ( JSP ) 의 국부적 인 오유수정 에 대 한 설명 을 끝마친다. 
실행결과를 확인한 다음 [Lomboz J 2 EE View ] 로부터 [ SampleChaplO ] — 
[ SimpleWeb ] —[Apache Tomcat v 5.0. x ] 를 선택하고 오른쪽찰칵하여 [Stop the 
launched Server ] 를 선택하고 Tomcat 를 정지시킨다. 
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그림 10-43. [ Debug ] 투시 
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JSP Servlet 원천파일을 취급할 때 발생하는 콤화일오유에 대하여 

JSP Servlet 원천파일 ( xxx _ jsp . java ) 을 Eclipse 에서 취급할 때 를파일오유 및 
표시 할 때 문자이지 러짐 이 생긴다. 이것은 클라스경로에 서고 ( jasper - runtime , jar ) 
가 맞지 않는것，그리고 Tomcat 가 JSP Servlet 원천파일을 Unicode ( UTF -8) 로 출 
력하는데 대 해 Eclipse 작업 대 의 기 정 부호화는 MS 932 로 되 고있 기 때 문에 나타나는 현 
상이다. JSP Servlet 원천파일을 수정 하지 않아도 오유수정은 문제없이 진행되지만 콤 
파일오유를 없애버리 자면 다음의 방법 을 리 용해 야 한다. 

A 클라스경로의 jasper - runtime , jar 의 추가 

[ Navigator ] 보기상에서 [ SampleChaplO ] 을 선택하고 오른쪽찰칵하여 [ Properties ] 
를 선택 하면 프로젝 트의 [ Properties ] 대 화칸이 열 린 다. [Java Working Path ] 를 선 
택하여 대 화칸의 오른쪽의 [ Library ] 태 브를 선택 하고 [Add External JAR ] 를 선택 
한다. 《 / opt / Tomcat / common / lib / jasper - runtime , jar 》 를 선택하고 [ Open ] 단추 
로 추가한다. 다음 [ OK ] 단추를 찰칵하여 대 화칸을 닫는다. 

A 부호화문제의 처리 

해당한 JSP Servlet 원천파일이 선택된 상태에서 차림표띠로부터 [ Edit ]-〉 
[ Encoding ]-〉[ UTF -8] 을 선택하고 파일의 부호화를 UTF -8 로 변환한다. 다음 
JSP Servlet 원천파일을 수정하고 보존할수 있는 상태로 한다. 그리고 보관 및 건립을 
진행한다. 그러면 JSP Servlet 원천파일의 콤파일오유 및 문자이지러짐은 해소된다. 


10.5.5. 종업원검색결과화면 ( JSP ) 의 원격오유수정 

여기에서는 종업원검색결과화면을 실례들어 JSP 의 원격오유수정에 대하여 설명 한다. 

1. 오유수정의 준비 

[10.5.4. 종업원검색결과화면 ( JSP ) 의 국부적인 오유수정]에서 설명한 상태설정파 
일의 설정，클라스파일의 복사 및 JSP Servlet 원천파일의 취급이 진행된것을 확인한다. 

2. Tomcat 의 기동 

[10.5.3. 종업원검색 Servlet 의 원격오유수정]의 [Tomcat 의 기동서술의 편집과 기 
동] 에 서 작성 한 startup _ debug . bat 를 리 용하여 Tomcat (오유수정 항목이 부가된)를 기 
동한다. 기동화면에서 표시되는 4자리의 포구번호를 변화시킨다(그림 10-44). 
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그림 10-44. 오유수정방식으로 Tomcat 기동 


3. 멈춤점의 설정 

[10.5.4. 종업원검색결과화면 ( JSP ) 의 국부적인 오유수정]의 [멈춤점의 설정]에서와 같 
은 방법으로 종업원검색결과화면의 JSP Servlet 원천파일 ( memberSearchOKJsp . java ) 에 
멈 춤점 을 설정한다(그림 10-45). 

4. 원격오유수정시 기동구성의 설정 

Eclipse 상의 차림표띠로부터 [ Run ] — [ Debug ] 에서 [ Create , manage , and run 
configurations ] 대화칸을 열고 대화칸왼쪽에서 [10.5.3 종업원검색 Servlet 의 원격 오 
유수정]의 [원격오유수정용의 기동구성의 설정]에서 등록한 [Remote Java Application ] 
— [ SampleChaplO ] 을 선택 한다. [Connection Properties ] 의 포구로 선정 변환한(또는 
기 동선택 항목안에서 address=XXXX 로 지 정한) 4자리 의 수자를 입 력한다. 그림 10-46 
과 같이 설정된다. 
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그림 10-45. [ Debug ] 투시 
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그림 10-46. 원격오유수정용 기동구성의 설정 

[ Apply ] 단추를 찰칵한다. 다음 [ Debug ] 단추를 찰칵하고 Tomcat 에 원격 접 속한다. 
그러면 오유수정의 실행이 가능하게 된다. 

5. 오유수정의 실행 

열람기를 기동하여 《 Mtp :// localhost :8080/ SimpleWeb 》 로 종업원검색화면을 현 
시하고 종업원번호에 《1》을 입력한 다음 [검색실행]단추를 찰칵한다. 그러면 Eclipse 
의 화면이 [ Debug ] 투시로 절환되 

- ^IcrnbcrSc^rcli&Gi 

C * 5 oi ™ Ha 대 

n ， 命令， < 


S 춤점들 설 S 


고 멈줌점을 설정한 행에서 정지된다(그림 10-47). 
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그림 10-47. 멈춤점의 설정 
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화면왼쪽우의 [ Debug ] 보기의 도구띠에 배치된 단추를 리용하여 걸음실행을 진행한 
다. [ Replay ] 단추를 찰칵하면서 마지막까지 처리가 실행되면 열람기에 실행결과가 표시 
된 다. 

이 상으로 종업 원검 색 결과화면 ( JSP ) 의 원격 오유수정 에 대 한 설명 을 끝마친다. 열 람 
기로부터 《/ opt / Tomcat / bin 》 에 있는 《 shutdown . sh 》 를 두번찰칵하여 Tomcat 를 정 
지시킨다. JSP 의 오유수정표준작업에서 설정한 《 SimpleWeb . xml 》 파일을 지우고 복사해 
둔 [ SampleChaplO / SimpleWeb / WEB - INF / classes ] 아래의 클라스파일도 지워버 린다. 
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제 11 장 . JBossHDE 에 으 I 한 J2EE 개발 
제 1 절 . JBoss 오 F JBossHDE 


11.1.1. JBoss 

JBoss 는 현재 크게 주목되 고있는 공개원천의 J 2 EE 응용봉사기 이 다. 최 신판본 
( ver 3. 2. 5) 에 서 는 Tomcat 5. 0.26, JSP 1.2 ， Servlet 2. 3, EJB 2.0, JCA , JTA , JMX 
등을 포함한 J 2 EE 1.3 의 거의 모든 기능을 지원하고있으며 대규모체계에서 없어서는 안 
될 무리짓기기능 ( clustering ) 까지 부여하고있다. 허가료금을 물 필요가 없으며 상업용 
으로 리용하는 경우에도 무료로 쓸수 있다. 

이 장에서는 JBoss 와 Eclipse 를 련동시켜 J 2 EE 응용프로그람의 실행 및 오유수정를 
진행하는 방법 에 대 하여 설명한다. Windows 판본에 기 초하여 설명 하기때 문에 Linux 에 
서 쓸 때 에는 해 당한 설정을 진행하여 야 한다. 

11.1.2. JBoss-IDE 

JBoss - IDE 는 J 2 EE 개 발지 원을 위한 Eclipse 의 끼워넣기 이다. 1.3. 30판본에서는 다 
음과 같은 기능을 제공하고있다. 

• XDoclet 의 지원 

• JBoss 봉사기의 시동과 정지 

• JBoss 봉사기상에서의 오유수정 및 감시 

• 보존자료(또는 적재한 등록부로서 의 )의 패 키지 화배 치 를 형성하는 간단한 방법 

• J 2 EE 요소를 JBoss 봉사기 에 배 치 하기 위 한 기 능 

• J 2 EE 요소의 개발조수 

여 기서 는 JBoss - IDE 를 사용한 EJB 의 개 발방법 에 대 하여 소개한다. 

11.1.3. XDoclet 

XDoclet 는 공개원천인 코드생성엔진이다. XDoclet 는 원천코드를 해석하고 
JavaDoc 에 서 술되 여 있는 특별한 서 술자 (8 web . servlet , Qjboss . ejb-ref 등) 에 기 초하 
여 서술문서 ( web . xml , ejb - jar.xml 등)나 원천 ( EJB 기본대면， EJB 원격대면 등)을 자 
동생성한다. XDoclet 는 Ant 의 과제 로서 실행된다. XDoclet 를 사용하면 개 발에서 생 산 
성을 향상시킬수 있다. 
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제2절. 설치와 설정 

JBoss 와 JBoss-IDE 는 《 http://www.jboss.org 》 로부터 무료로 내리적재할수 있다. 

11.2.1. JBoss 의 설치 

JBoss 의 설치는 다음과 같은 순서 로 진행한다. 

1. 먼 저 J2SDK 를 설 치한다. 

2. jboss-3. 2. 5. zip 를 리 용하여 JBoss 를 설 치 한다. Jboss-3. 2. 5. zip 를 적 당한 등 
륵부(여기서는 C:/KUT) 에 풀어놓는다. 

3. 다음으로 환경 변수를 설정한다. 

설정할 환경 변수는 표 11-1 과 같다. 


표 11-1. 

설정할 환경변수 

환경 변수 

경 로 

JAVA—HOME 

PATH 

JBOSS.HOME 

J2SDK 의 설 치등록부(여 기서는 C ： /KUT/j2sdk) 
%JAVA_HOME%/bin 

JBoss 의 설치등록부(여기서는 C ： /KUT/jboss-3.2.5) 


4. 다음으로 JBoss 의 기동을 확인한다. 기동은 《 %JBOSS_HOME%/bin> 등록부에 
있는 run. bat 를 실 행하여 실 행한다. 

5. 기동하면 그림 11-1 과 같은 지령입력재촉화면이 나타난다. 


= 23,859 
： 23,984 
093 

:24.062 

： 24,249 

/jboss-3 

： 25,140 

/jboss-3 

： 26,562 


INFO [C] Bound to JNDI name: queue/C 

INFO [D] Bound to JNDI name: queue/D 

INFO [ex] Bound to JNDI name : queue/ex 

INFO CtestTopic] Bound to JNDI name : topic/testTopic 

INFO CsecuredTopic] Bound to JNDI name: topic/securedTopic 

INFO [testDurableTopic] Bound to JNDI name : topic/testDurableTopic 

INFO [testQueue] Bound to JNDI name : queue/testQueue 

INFO CUILSeruerlLSeruice] JBossMQ UIL service available at : /0.0. 

INFO [DLQ] Bound to JNDI name : queue/DLQ 

INFO [TomcatDeployerl deploy ， ctxPath=/jnx-console, warUrl=file：/L 
3.2.5/seruer/default/deploy/jnx-console.war/ 

INFO [TomcatDeployerl deploy ， ctxPath=/web-console, warUrl=file：/L 
3 - 2 - 5/sei % uer/default/tnp/deplov/tiip23428web-console - war/ 

INFO [Server] JBoss <NX MicroKernel) [3.2.5 〈 build: CUSTag=JBoss_3 
"" 860ns 

NFO ᅳ 


J 





그림 11-1. JBoss 기동화면 
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열람기를 기동시키고 《比竹0://100신110아:8080/짜613-(：0113016/》에 접근한다. 그 
림 11-2 와 같은 화면이 나타나면 정 확히 설치 가 끝났다는것을 의미한다. 



그림 11-2. JBoss Web 조종탁 

봉사기를 정지하려면 지령입력재촉화면에 다음과 같이 써넣으면 된다. 

C : / KUT / jboss -3. 2. 5/ bin / shutdown , bat _S 

또한 그림 11-1 의 지령입력재촉상에서 Ctrl + C 를 입력해도 봉사기를 정지시킬수 있다. 

11.2.2. JBoss - IDE 의 설치 

JBoss - IDE 의 설 치는 다음과 같은 순서 로 진행한다. 

1. Eclipse 를 기동한다. 

2. [ Help ] ^ [Software Updates ] —[Find and Install ] 를 선택 한다. 

3. [Search for new features to install ] 을 선택 하고 [ Next ] 단추를 찰칵한다. 
[New Remote Site ] 를 클릭하여 현시되는 대화칸의 [ Name ] 에 《 JBoss - IDE 》 를 입력 
하고 [ URL ] 에《 h 竹 p :// jboss . sourceforge . net / jbosside / updates 》를 입력 한 다음 
[ OK ] 단추를 찰칵한다. 

4. 일 람에 표시되여있는 [ JBoss - IDE ] 를 선택하고 [ Next ] 단추를 찰칵하면 지정한 
URL 로부터 설치가능한 JBoss - IDE 의 검색을 시작한다. 

5. 설치가능한 특성정보과 판본이 현시된다. 설치할 JBoss - IDE (여기서는 1.3.30) 
을 선택하고 [ Next ] 단추를 찰칵한다. 

6. 다음으로 허 가의 확인화면，설치할 특성정보의 확인화면이 련이 어 나타나는데 

[I Accept the agreement ] 를 선택하고 [ Next ] —[ Finish ] —[ Install ] 의 순서로 진행한다. 
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7. 설치를 끝내면 Eclipse 의 재기동을 독촉하는 대화칸이 나타나므로 재기동을 한 
다. 이것으로써 설치는 끝난다. 


대 리봉사기를 경유하여 JBoss-IDE 를 설치하는 경우 [Window] ᅳ [Preferences (설 
정)]— Install/Update ([설치/갱신)]을 선택하고 [대리설정]의 [Enable HTTP proxy 
connection] 를 선택하여 대리봉사기의 주소와 포구를 입력한다. 


11.2.3. JBoss - IDE 의 설정 

JBoss-IDE 에서 JBoss 봉사기의 기동，정지 등을 진행 하기 위한 설정 을 한다. 


1. [Window] ^ [Show View] —[Other] —[JBoss-IDE] —[Server Navigator] 를 
선택하고 [OK] 단추를 찰칵하면 [Server Navigator] 보기가 나타난다 (그림 11-3). 


PTGhteiM Jjvad« Ofedai-MilW Coti ： 5 ： o) & Talks ^ 巧 향、 


shut down 

start - 1 | configuratton 


url m □ᄆ 


그림 11-3. [Server Navigator ] 보기 

2. 다음으로 이 번에 사용하는 JBoss 봉사기 의 구성 에 관한 설정 을 진행한다. 

[Server Navigator] 보기 의 [configuration] 단추를 찰칵하면 [Debug] 대 화칸이 나 
타난다(이 보기의 임의의 장소에서 오른쪽찰칵하여 [configuration] 를 선택해도 된다) . 
여 기서는 JBoss3.2.5 를 전제 로 하고있기때 문에 화면왼쪽의 [configuration] 안에서 
[JBoss 3.2. 뇌를 오른쪽찰칵하고 [New] 를 선택한다. 기 정 으로는 이 구성 의 이 름이 
[New configuration] 으로 되 여 있으므로 적 당한 이름으로 변경 한다. 여 기서 는 
«JBoss3.2.5» 라고 한다. 

[Home] 래 브의 [JBoss 3.2.x Home Directory] 에 이 번에 리 용하는 JBoss 의 홈등 
륵부를 입 력한다. 여 기서 는 《 C:/KUT/jboss-3.2.5 》 라고 입 력한다. 다음으로 [Start] 
래브를 찰칵하고 [Program parameters (프로그람인수)] 에 《 -call 》 를 입력 한다. [JDK] 
태 브에 는 JRE 가 아니 라 JDK 의 홈등록부를 지 정한다. [Apply] ᅳ [Close] 의 순서 로 선 
택하면 설정 이 끝난다(그림 11-4). 
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JBOS03. 2.52H1 입력 


JBois_HOMEH 입력 


그림 11-4. JBoss 구성화면 


우의 설정에서 프로그람인수로 《 -c all 》를 입력하였는데 JBoss 에는 [ minimal ], 
[ default ] , [ all ] 의 3가지 설정 이 있다. 여 기서 는 EJB 를 사용하기때 문에 [ all ] 설정 을 
사용한다. 이것을 위한 기동선택이 《-c all 》 이다. 자세한것은 표 11-2 에 보여주었다. 


표 11-2. 

JBoss 봉사기표준설정값 

설정값이 ■ 

개 요 

minimal 

JMX / JBoss 만을 사용할 때 지 정한다. Web 용기， EJB 용기， JMS 는 
포함하지 않는다. 

Default 

독립 J 2 EE 봉사기 를 실행 하기 위한 설정 이 다. RMI / IIOP 와 Web 봉사 
는 포함하지 않는다. 파라메터 를 주지 않고 기 정 으로 JBoss 봉사기 가 
기동한다. 

All 

리 용가능한 봉사를 모두 개시한다. 여 기 에는 기정 에서 적재하지 않 
는 RMI / IIOP , Web 봉사를 포함하고있다. 


Eclipse 상에서 JBoss 를 기동해보면 다음과 같다. 

JBoss 봉사기 의 구성 이 작성 되 면 [Server Navigator ] 보기 에 [JBoss 3. 2. 5] 가 표시 
된 다. 그것 을 선택 하고 [ start ] 단추를 찰칵하면 JBoss 봉사기 가 기 동된 다. 표준출력 은 
Eclipse 상의 조종탁보기 에 출력된다. 또한 JBoss 봉사기의 정지는 [ shutdown ] 단추를 
찰칵하면 된다. 
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제 3 절 . EJB 의 작성과 실행 

11.3.1. EJB 응용쏘프트웨어 의 작성 

EJB (Enterprise JavaBeans ) 란 J 2 EE 가동기 반의 봉사기 측요소이 다. EJB 에 는 Stat 
elessSessionBean , StatefullSessionBean , BMPEntityBean , CMPEntityBean , 
MessageDrivenBean °1 있 다. 여 기 서 는 EJB 에 대 하여 구체 적 으로 설명 하지 않고 
JBoss - IDE 를 사용한 EJB 의 작성 및 실 행 방법 에 대 하여 설 명한다. 

이 장에 서 는 10장에 서 작성한 종업 원검 색 을 진행하는 응용프로그람을 EJB 
( StatelessSessionBean ) 를 사용하여 작성 하기로 한다. 제10장에서는 JSP , Servlet 및 
검색론리를 가지는 Java 클라스로 처리를 했지만 여기서는 검색론리를 EJB 로 바꾼다(그 
림 11-5). 


Controller 



그림 11-5. EJB 로 작성 한 종업원검색응용프로그람에서의 처리방식 

표 11-3 은 종업 원검 색응용프로그람 EJB 판의 각 구성 요소의 개 요와 제10장에 서 변 
경된 내용을 보여준다. 화면변화에 대해서는 변경이 없으므로 제 10장과 같다. 


표 11-3. 종업원검색응용프로그람 EJB 판의 각 구성요소의 변경된 내용 


명 칭 

형 식 

변경 점 

종업원검색화면 

HTML 

POST 목적 지 의 URL 를 변경한다. 

종업원검색 Servlet 

Servlet 

종업원검색 클라스의 호출을 종업원검색 

EJB 의 호출로 변경한다. 

종업원 EJB 

EJB 

Java 클라스로부터 EJB 로 변경한다. 자료 
검색의 처리자체에 변경은 없으나 메쏘드 
의 서명을 변경한다. 

검색자료보존클라스 

Java #^]-^ 

오유처 리의 마당，메쏘드를 추가한다. 

종업원검색결과화면 

JSP 

자료보유클라스명 을 변경한다. 

종업원검색오유화면 

JSP 

자료보유클라스명 을 변경한다. 


O 
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11.3.2. 프로젝트의 작성 

종업 원검 색응용프로그람 EJB 판의 개 발을 위하여 프로젝 트를 작성한다. 

여기서는 JBoss-IDE 를 리용하여 J 2 EE 프로젝트를 작성한다. Eclipse 의 차림표띠에서 
[ File ] —[ New ] —[ Other ] 를 선택하고 [ JBoss - IDE ] —[ J 2 EE Projects ] —[ J 2 EE 1. 3 Project ] 
를 선택한 다음 [ Next ] 단추를 찰칵한다. 프로젝트명으로《 SampleChapll 》를 입력하 
고 [ Next ] 단추를 찰칵한다(그림 11-6). 



J2EE 1.3 Project 



■7] 


뼤 plmpachBpiili - SampleChapll0IEH1 임 _ 



'：¥ - Usu dirfauHl 표 ) 


그림 11-6. J 2 EE 프로젝트작성대화칸 


다음으로 [Source Folder on the Build Path ] 과 [Default Output Folder ] 을 
설정한다. [Add of Folder ] 를 누르면 [New Source Folder ] 대 화칸이 나타난다. 
[Folder Name ] 에 《 src 》 라고 입력하고 [ OK ] 단추를 찰칵한다 (그림 11-7). 



FD r dEr namerl 비 由 ro 


src 라고 입력 


AdfP?ncDid(Aj> «■ 


그림 11-7. 새 원천서류철이들입력대화칸 


다음으로 [Default Output Folder ] 에 《 SampleChapl 1 /bin } 을 입력 하고 
[ Finish ] 단추를 찰칵한다(그림 11_8) . 
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J2EE t.3 Project 



―면 □■비 

m 


대 | 타 pfcDiecb ； SferV itr-srlK | .' v <5 『 dti 、 Bncf£K0oft | 
Scpurae fddcfs on buid p^th: 


SampleChapll/src 가 
추가도他 t 있는것 ■ 확인 



네 gufcaApUlf 대신 ■ 


l| ^-vmplisCh^Pl lifctn 


SampleGhapll/bin 
mm 임혁 



그림 11-8. J 2 EE 프로젝트작성조수 

이상으로 프로젝트 작성은 끝난다. 

패키지 열람기상에서 SampleChapll 가 등록되였는가를 확인한다. 


11.3.3. 종업 원검 색 화면 ( HTML ) 의 수정 

제10장에 서 작성한 종업 원검 색응용프로그람에 기 초하여 EJB 응용프로그람을 작성하 
기로 한다. 

우선 종업원검색화면 ( index . html ) 을 작성한다. HTML 이나 JSP 를 넣는 서류철을 작 
성한다. 패키지열람기에서 [ SampleChapll ] 을 오른쪽찰칵하고 [ New ] — [ Folder ] 을 선택 
한다. [Folder name ] 에 《 docroot 》 를 입 력 하고 [ Finish ] 단추를 찰칵한다(그림 11-9). 



finfcnr or sciect ihc psrcrt folder 
|^amptoChap]i 



sFdUw |pnu:l dccn»rl| 



doeroot 라고 입력 





그림 11-9. 새 서류철작성대화칸 
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다음으로 이 제 작성한 [ docroot ] 를 오른쪽찰칵하고 [ New ] ᅳ [ Other ] 를 선택한다. 
[ JBoss - IDE ] —[Web Comments ] —[HTML Page ] 를 선택 하고 [ Next ] 단추를 찰칵한다. 
[Input or select parent folder ] 에서 HTML 를 보관할 서류철을 지정한다. 여 기서 는 
방금 작성한 《 docroot 》 를 지정한다. 직접 《 SampleChapll / docroot 》 라고 입력하거 
나 화면중심에 있는 계층구조에서 《 docroot 》 를 선택한다. 또한 화면아래의 [File 
name ] 에 《 index . html 》 를 입력하고 [ Finish ] 단추를 찰칵한다(그림 11-10). 


3 , new HTML file 


■피정 




E.nigrof 대먀ᅵ【타 ᅵ서띠 ni N 的 r _ 

|5-smpleC=HplJjd«.™jiE _SampleGhapll /docroot 



m 입력 또는 선택 


Rl |||m| j I 

I- — 


m 1一 - 一 -1 




index.hlml 01 라고 입력 



그림 11-10. 새로운 HTML 작성대화칸 


패키지 열람기상에서 《 index , html 》이 작성되였는가를 확인한다. 《 index . html 》 
을 오른쪽찰칵하고 [Open With] ^ [Text Editor ] 를 선택하면 편집 기 상에 원천 이 나타 
난다. 목록 ii - i 과 같은 코드를 입 력한다. (굵은체 로 되 여있는 부분이 제10장의 코드에 
서 변경된 부분이 다. ) 제 10장에서 작성 한 《 index , html 》와는 Servlet 의 호출자리 가 달 
라졌 다. 


목록 11-1. 종업원검색화면 ( index . html ) 

<!DOCTYPE html PUBLIC “-// W 3 C//DTD XHTML 1.0 Transitional // 
EN ” w http ：// www . w 3. org / TR / xhtmll - transitional . dtd ” > 

<meta http - eqiv : “ Content - Type ” content : “ text / html ; charset = Shift _ JIS ” > 
< html > 

< head > 

〈 title 〉 종업 원검 색 〈/ title 〉 

</ head > 
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<body bgcolor = “# FFFFFF ” > 

<div align = “ center ” > 

< h 3> 검 색하려 는 종업 원번호를 입 력하십 시 오. </ h 3> 

<form name = “ MemberSearchForm ” method : “ post ” 
action = “/ SimpleWeb 2/ MemberSearchServlet 2” > 

(table with = “300” cellpadding = 10 align = “ center ” > 

< tr > 

<td width = “40%” bgcolor = “ lightblue ” > 

<div align = “ center ” 종업원번호 </ div > 

</ td > 

<td width = “60%” bgcolor = “ palegoldenrod ” > 

〈input type = “ text ” name = “ memberld ” > 

</ td > 

</ tr > 

〈/ table 〉 

< br > 

〈input type = “ submit ” name = “ submit ” value = “검색실행 ” > 
</ form > 

</ div > 

</ body > 

</ html > 


11.3.4. 검 색자료보존들라스의 작성 

검 색 자료보존클라스 ( MemberDataHolder 2. java ) 를 작성 한다. 제 10장의 종업 원검 
색 응용프로그람에서는 검색자료보존클라스의 구체 례생성은 Servlet 로 진행 하고 참조넘 
기기로 종업 원검색클라스에 넘겼다. EJB 응용에서는 참조넘 기기는 피 하는것 이 좋다. EJB 
에 원격접근한다는것은 인수의 객체는 직렬화되여 EJB 에 넘겨진다는것을 의미한다. 즉 
호출하는 측에서 생성된 검색자료보존클라스의 구체례를 EJB 로부터는 참조할수 없다. 
따라서 호출되는 측 ( EJB ) 에서의 변경 내용은 호출하는 측 ( Servlet ) 의 구체례에는 반영 
되 지 않는다. 다만 EJB 를 국부접 근으로 호출할 때 응용봉사기 의 설정 에 의하여 참조넘 
기기가 가능할 때도 있다. 

이 장의 실례에서는 원격접근할 때의 작성방법을 소개한다. 패키지열람기에서 
[ SampleChapll ] 를 오른쪽찰칵하고 [ New ] 구 [ Class ] 를 선택한다. [ Package ] 에 《sa 
mple . common 》 을 입 력 하고 [ Name ] 에 《 MemberDataHolder 2 》를 입 력 하며 [Interf 
ace ] 에 [ java . io . Serializable ] 를 추가한다. [Which method stubs wold you like 
to create ?] 의 선택을 모두 해제하고 [ Finish ] 단추를 찰칵한다 (그림 11-11). 
[ java . io . Serializable ] 을 실현하는 리유는 객체의 직렬화를 가능하게 하기 위해서이다. 
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그림 11-11. 새로운 Java 클라스작성대화칸 

MemberDataHolder 2. java 가 작성되고 편집기에 표시되는데 목록 11-2 의 코드를 
입 력한다(굵은체 로 된 부분은 제10장의 코드에 서 추가 또는 수정할 코드이 다. ) . EJB 에 
오유가 있는가를 판정 하기 위하여 boolean 형 의 변수와 메 쏘드를 추가하고있다. 

목록 11-2. 종업원 자료보유클라스 ( MemberDataHolder 2. java ) 

/* * 

* 작성날자 200 X / XX/XX 

* 

* TODO 이 생성된 파일의 형판을 변경하려면 다음으로 넘어뛰기: 

* 창문 설정 Java 코드격 식 코드형 판 

*/ 

package sample . common ； 
import java . io . Serializable ； 


* Qauthor KUT 


* TODO 이 생성된 형해설문의 형판을 변경하려면 다음으로 넘어뛰기: 

* 창문 설정 Java 코드격식 코드형 판 

*/ 


Public class MemberDataHolder 2 implements Serializable { 
private String id ； 
private String name ； 
private String address ； 
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private String message ； 
private Boolean isError ； 

/** 

* 9 return address 를 되돌린다. 

*/ 

public String get Address () { 
return address ; 

} 

/** 

* 9 param address address 를 설정 
*/ 

public void setAdress (String address ) { 
this , address = address : 

} 

/** 

* 9 return id 를 돌린다. 

*/ 

public String getldO { 
return id ； 

} 

/** 

* 9 param id id 를 설 정 . 

*/ 

public void setld (String id ) { 
this , id = id ； 

} 

/** 

* Sreturn isError 를 돌린다. 

*/ 

public Boolean isError 0 { 
return isError ； 

} 

/** 

* 通 param isError isError 를 설정. 

*/ 

public void setError (Boolean isError ) { 
this . isError = isError ； 

} 

/** 

* 9 return message 를 돌린다. 

*/ 
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public String getMessageO { 
return message ； 

} 

/** 

* 9 param message message 를 설 정 . 
*/ 

public void setMessageO { 
this , message = message ； 

} 

/** 

* 9 return name 를 돌린다. 

*/ 

public String getNameO { 
return name ； 

} 

/** 

* 9 param name name 을 설 정 . 

*/ 

public void setName (String name ) { 
this , name = name ； 


11.3.5. 종업원검색 EJB 의 작성 

종업 원검 색 EJB ( MemberSearchBean . java ) 를 작성 한다. 여 기서는 StatelessSessi 
onBean 을 작성 하지만 다른 EJB ( EntityBean 이 나 MessageDrivenBean ) 도 쉽게 작성 할 
수 있다. [ SampleChapll ] 를 오른쪽찰칵하고 [ New ] —[ Other ] 를 선택 한다. [ JBoss - IDE ] 
— [EJB Components ] — [Session Bean ] 을 선택하고 [ Next ] 단추를 찰칵한다. 

[ Package ] 에 는 《 sample , ejb 》， [ Name ] 에 는 《 MemberSearchBean 》를 입 력 한 
다. [ Interface ] 에 는 ( javax . ejb . SessionBean } ， [Select the type of the EJB ] 에 
서는 [ Stateless ] 를 선택하고 [Select the access of the EJB ] 에서는 [ Remote ] 를 선 
택한다. [Which method stubs would you like to create ?] 에서는 모두 선택 하고 
[ Finish ] 단추를 찰칵한다(그림 11-12). 

다음으로 EJB 로서 외 부에 공개하는 메 쏘드를 추가한다. 

패 키 지열람기에서 [ MemberSearchBean ] 을 오른쪽찰칵하고 [ J 2 EE]—[As Business Method ] 
를 선택한다. 여기서 [ MemberSearchBean . java ] (파일)과 [ MemberSearchBean ] (클라스) 
의 차이에 주의 해야 한다. [ MemberSearchBean . java ] 를 오른쪽찰칵했다면 차림표에 
[ J 2 EE ] 는 나타나지 않는다. 

[Method Name ] 에 《 search 》를 입력하고 [Return Type ] 에 앞에서 작성한 
《 sample , common . MemberDataHolder 2 》를 입력 한다. [ Parameters ] 에 java . lang . String 
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형의 《id》 를 추가하고 [Select the view type to use] 에서는 [Remote] 를 선택한 
다음 [Finish] 단추를 찰칵한다(그림 11-13). 이렇게 하여 외부공개메쏘드가 추가된다. 



sample.0jb 라고 입력 

MemberSearchBeanOI 라고 
입력 


3E 交基 설정한다 


그림 11-12. SessionBean 작성대화칸 

편집 기 로 직 접 입 력하는 방식 과 다른 점 은 XDoclet 와 관련된 점 이 다. 추가한 메 쏘 
드의 해설문에 [8ejb] 로 시작되는것이 추가되였다. 해설문을 자동적으로 추가하고있다. 
목록 11_3의 search () 메 쏘드의 JavaDoc 해설 문을 참조하면 [8ejb. interface-method 
view_type= “remote” ] 가 자동삽입되 여있음을 알수 있다. 



search 라고 입력 


Sample,ccMitmon.Mamber 

DataHolder2 

01라고 입력 또는 선택 

CAdd^M 놀러 String 형의 
변수 Cid 》 휨 추가 


그림 11-13. 업무메쏘드작성 대화칸 
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목록 11-3 과 같이 코드를 입 력 한다 . SearchO 메 쏘드의 내 용은 제 10 장에서 작성 한 
MemberSearch 클라스와 거의 같다 . 

목록 11-3. 종업원검색 EJB(MemberSearchBean.java) 

/* 

* 작성날자 : 200X/XX/XX 

* 

* TODO 가 생성된 파일의 형 판을 변경하려 면 다음으로 건너뛰 기 : 

* 창문 설정 Java 코드격식 코드형판 
*/ 

package sample, ejb ； 

import java.io.File ； 

import java. rmi. RemoteException ； 

import javax. ejb. EJBException ； 
import javax. ejb. SessionBean ； 
import javax. ejb. SessionContext ； 
import javax. ejb. CreateException; 

import javax.xml.parsers.DocumentBuilder ； 
import javax.xml.parsers.DocumentBuilderFactory : 

import org.w3c.dom.Document; 
import org.w3c.dom.Element ； 
import org. w3c. dom. ModeList ； 

import sample, common. MemberDataHolder2 ； 


* Sejb.bean name= “MemberSearch” 

* display_name= “Name for MemberSearch” 

* description^ “Description for MemberSearch 

* jndi_name= w ejb/MemberSearch 

* type= “Stateless” 

* view-type= “remote” 


public class MemberSearchBean implements SessionBean { 

private static final String filePath = “C://ASCII//workspace 
/ SampleChapl 1/ / SimpleWeb2 // member, xml ’’ ; 
private static final String msglnputError = 

“ 종업원 ID 가 입력되지 않았습니다 ” ; 
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private static final String msgSearchSuccess = 

“종업원정보검색에 성공하였습니다 .” ; 
private static final String msgSearchError = 

“해당되는 종업원정보가 없었습니다 . ” ; 
private static final String msgFailure = 

“종업 원정 보의 검색 에서 장애 가 발생하였습니 다 . 

private static ModeList memberList ； 


private SessionContext ctx ； 


*/ 


public MemberSearchBean () { 
superO; 

// TODO 자동생성된 메쏘드대용체 

} 

/* (Javadoc 가 아님 ) 

* Ssee javax. ejb. SessionBean#ejbActivate() 

*/ 

public void ejbActivateO throws EJBException, RemoteException { 

// TODO 자동생성된 메쏘드대용체 

} 

/* (Javadoc 가 아님 ) 

* Ssee javax. ejb. Session#ejbPassivate() 

*/ 

public void ejbPassivateO throws EJBException, RemoteException { 
// TODO 자동생성된 메쏘드대용체 

} 

/* (Javadoc 가 아님 ) 

* Ssee javax. ejb. SessionBean#ejbRemove() 

*/ 

public void ejbRemoveO throws EJBException, RemoteException { 
// TODO 자동생성된 메쏘드대용체 

} 

/* (Javadoc 가 아님 ) 

* 9see javax. ejb. SessionBean#setSessionContext (javax. ejb. SessionConte 

* xt) 

*/ 



錢變邊 0 變變©繼鹽 


327 







H 너•參於경 Eclipse 


public void setSessionContext(SessionContext ctx) 
throws EJBException, RemoteException { 
This, ctx = ctx ； 

} 

/** 

* Default create method 


* 9th rows C reateException 

* 9ejb. create-method 
*/ 

public void ejbCreate 0 throws CreateException { 
//TODO auto-generated method stub 

} 

/** 

* Business method 

* ejb.interface-method view-type = “remote” 

*/ 


public sample, common. MemberDataHolder2 search (java. lang. String id) { 
// 반환용검 색자료보존클라스생 성 

MemberDataHolder2 mdh = new MemberDataHolder2() ； 

Try { 

// memberList 가 없는 경우 member.xml 로부터 얻기 
if (memberList == null) { 

DocumentBuilderFactory dbfactory = 

DocumentBuilderFactory. newInstanceO; 
DocumentBuilder builder = 

dbfactory. newDocumentBuilder(); 

Document doc = builder, parse (new File(filePath)) : 

Element root = doc.getDocumentElementO ； 
memberList = root. getElementByTagName( “member” ) ； 

} 

// 종업원 ID 가 빈 문자인 경우 
if (id == null || id.equals( “ ” )) { 
mdh. setMessage(msglnputError); 
mdh. setError(true); 
return mdh ； 
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// 종업원 ID 를 설정 
mdh. setld(id) ; 


// memberList 로부터 넘겨 받은 종업원 ID 와 같은 종업원을 검색 
for (int i = 0; i < memberList.getList.getLength() : i++) { 

// 넘겨 받은 종업원 ID 인가 . 

if (id. equals (element. getAttribute ( “id” ))) { 

NodeList nameList = element. getElementByTagName( “name” ); 
Element nameElement = (Element) nameList. item (0) ； 
mdh. setName (nameElement. getFirstChildO. getNodeValue 0) ； 

NodeList addressList = Element. getElementByTagName( “address” )； 

Element addressElement = (Element) addressList. item (0) : 
mdh. set Address ( 

addressElement. getFirstChild0. getNodeValue0) ； 

// 찾으러는 종업원이 존재하는 경우 
mdh. setMessage(msgSearchSuccess); 

return mdh ； 


// 찾으러 는 종업 원 이 존재하지 않는 경 우 
mdh. setMessage(msgSearchError) ; 
mdh. setError(true) ； 

} 

cath (Exception e) { 

// 례외가 발생한 경우 

mdh. setMessage(msgFailure); 

mdh. setError(true); 

} 

return mdh ； 


다음으로 종업원목록 (member, xml) 을 작성하는데 내용은 제 10 장에서 작성한 member, xml 와 
같다 . 다만 파일의 배 치장소는 《 SampleChapll/SimpleWeb2/member.xml 》 이 다 . 
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11.3.6. EJB 와 관련한 파일의 작성 

EJB 와 관련하는 클라스 ( 홈대면부， 원격대면부 ) 및 서술자 (ejb-jar. xml, 
jboss.xml) 는 Xdoclet 가 자동생성한다 . 여 기서는 Xdoclet 의 정의를 진행한다 . 
[SampleChapll] 를 오른쪽찰칵하고 [Properties] 을 선택한다 . [SampleChapll 의 속 
성]대 화칸에서 [Xdoclet Configurations] 를 선택하면 화면오른쪽에 Xdoclet 의 정의 화 
면 이 표시된다 . 상부령역 에서 오른쪽찰칵하고 [Add] 단추를 선택하면 [Configuration 
Name] 대화칸이 표시되기때문에 [Name] 에 〈〈 EJB 》 라고 입력하고 [OK] 단추를 찰칵한다 . 
이것으로 EJB 용의 새로운 설정이 작성되였다(그림 11-14). 



그림 11-14. Xdoclet 정의대화칸 

작성 된 [지리 는 상부령역 에 표시되 게 된 다 . 상부령역 의 [EJB] 를 선택 하고 왼쪽아 
래 령 역 에서 오른쪽찰칵하고 [Add Doclet] 를 선택한다 . 그러면 [Choose an entry] 대 
화칸이 나타나는데 여 기서 [ejbdoclet] 를 선택 하고 [OK] 단추를 찰칵한다(그림 
11-15). 
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Choose an entry 


documentdodet 


ejbdodet 


hiberratedoclet 

jdodDclet 

jmxdocEet 

mockobjectdoclet 

portletdoclet 

springdodet 

webdoclet 

xdoclet 


OK 


Cancel 


그림 11-15. [Choose an entry] 대화칸 

왼쪽아래령역에 [ejbdoclet ] 가 있는것을 확인할수 있다 . [destDir ] 를 두번찰칵하면 
현시 되 는 [A 竹 ribute Value] 대 화칸에 《 src 》 라고 입 력 하고 [OK] 단추를 찰칵한 다음 검 
사칸에 검 사표시 를 한다 . 마찬가지 로 [ejbSpec] 에 《 2.0 》라고 입 력 하고 검 사표시 를 한 
다 . 여기서 검사표시를 하지 않으면 우에서 정의한 설정이 무효로 된다(그림 11-16). 


SampleChap1 1 Property 



Beanlnfo P 石 Eh 
Builders _ 


XDoclet Conftgu 『묘 tmo 


Build Path 
Java Compilef 

LtKation 
Task Tags 
Project References 


□ jxj 


XDoclet Configurations 


Define the XDacfet configuration availsbEe for genera 대 on 


因 g EJB 



0_ OClet OaddedT; 


171 deslDir src 
ᄆ getCSass 
|7| ejbSpec 2.0 
「I exclydeT 
ᄆ force 
ᄆ mergeDir 
□ verbose 


OK Cancel 


그림 11-16. ejbdoclet 의 정의 
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다음으로 부과제를 추가한다 . 왼쪽아래 령역의 [ejbdoclet] 를 오른쪽찰칵하고 
[Add] 단추를 선택 한다 . [Choose an entry] 대화칸이 현시되는데 여기서 [fileset] 를 선 
택하고 [OK] 단추를 찰칵한다 . 왼쪽아래 령 역 에 [ejbdoclet] 의 부과제 로서 [fileset] 가 
나타난다 . [fileset] 를 선택 하고 오른쪽아래령역의 [Property] 에서 우와 같은 방법 으로 
입 력 한다 . 

[dir] 에 《 src 》 를 입력 하고 검사표시하며 [includes] 에 《 **/*Bean. java 》 를 입 력 
하고 검사표시한다 . [excludes] 는 검사표시를 해제한다 . [includes] 의 지정은 원천파일 
명의 마지막에 [Bean.java] 라고 붙은것만 EJB 로서 인식시키기 위한것이다(그림 11-17). 



그림 11-17. fileset 의 정의 

이제부터 지금까지의 진행한 방법 대 로 정의를 진행한다 . 

[ejbdoclet] 를 오른쪽찰칵 — [Add] 를 선택 —목록으로부터 [deploymentdescriptor] 를 
선택 — [OK] 단추를 찰칵한다 . 왼쪽아래 령 역 에서 [deploymentdescriptor] 를 선택 하고 
오른쪽아래령역의 [dest Dir] 에 《 src/META-INF 》 를 입력하고 검사표시한다 . 

다음으로 [ejbdoclet] 를 오른쪽찰칵 — [Add] 를 선택 ᅳ목록으로부터 [jboss] 를 선택 
ᅳ [OK] 단추를 찰칵한다 . 왼쪽아래 령역 에서 [jboss] 를 선택 하고 오른쪽아래령역 에서 
[Version] 에 《 3. 0 》을 입 력 하고 검사표시 하며 [destDir] 에 《 src/MET-INF 》 를 입 력 
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하고 검사표시 한다 . 

또한 [ejbdoclet] 를 오른쪽찰칵 — [Add] 를 선택—목록으로부터 [packageSubstitution] 
을 선택 — [OK] 를 찰칵한다 . 왼쪽아래 령 역 에서 [packageSubstitution] 을 선택 하고 오 
른쪽아래 령 역 에 서 [packages] 에 《 ejb 》를 입 력 하고 검 사표시 하며 [substituteWith] 에 
(interfaces 》를 입 력 하고 검 사표시 한다 . 

마지막으로 [ejbdoclet] 를 오른쪽찰칵 — [Add] 를 선택ᅳ목록에서 [remoteinterface] 를 
선택ᅳ [OK] 를 찰칵한다 . 마찬가지로 [homeinterface] 도 선택한다 . 이 부과제들에 대하 
여서는 속성지정을 하지 않는다 . 이상으로 설정은 끝난다(그림 11-18). [OK] 단추를 찰칵하 
고 완료한다 . 



Beanlnfo Path 
Builders 


XDoclet Configuration 


Java Build Path 
Java Compiler 
Javadoc Location 
Java Task Tags 
Project References 


因 田 


XDoclet Configurations 



Define the XDoclet configuration available for generation 


因國 EJB 


0 ejbdoclet 

，、，，•， Value 

["1 addedTa 

0 deploymentdescriptor 

[71 destOir src 

0 fileset 

I"! ejbClass 

0 homeinterface 

f7| ejbSpec 2.0 

0 jboss 

「| excluded 

0 packageSubstitution 

「1 force 

0 remoteinterface 

□ mergeDir 

□ verbose 


OK 


Cancel 


그림 11-18. 입력이 끝난 Xdoclet 정의대화칸 


이제 Xdoclet 를 실행시켜본다 . 패키지열람기상에서 [SampleChapll] 를 오른쪽찰칵하 
고 [Run Xdoclet] 를 선택한다 . [SampleChapll/src/sample/interfaces/MemberSearch. 
java] ， [SampleChapll/src ’ sample/interfaces/MemberSearchHome. java ] ， 
[SampleChapll/src/META-INF/ejtrjar. xml ] ， [SampleChapl 1/src/META-INF/jboss. xml] 
가 작성된다 . 패키지열람기상에서 확인할수 없는 경우에는 F5 건을 누르면 화면이 갱신된다 . 
실행결과는 조종탁보기에 출력된다(그림 11-19). 
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[Tasks f m Console 然 ~■ 쪼 | £■ 오 | Cf ■， = D 、 

<finished> SampleChap11 xdoclet-build.xml [Ant Build] \KUTAj2sdk\bin\javaw.exe (2004/10/14 192422) 

[ejbdoclet] (XDocletMain.start 47 ) Running <remotejnterface/> — 

[ejbdoclet] Generating Remote interface for 1 sample.ejb.MemberSearchBean', 

[ejbdoclet] (XDocletMain.start 47 ) Running <homeinterface/> 

[ejbdoclet] Generating Home interface for 'sample.ejb.MemberSearchBean', 

_generation_; 

BUILD SUCCESSFUL 
Total time: 3 seconds 


JB 


그림 11-19. Xdoclet 의 실행결과 

출력된 파일의 내용은 목록 11-4 〜목록 11-7 에 있다 . 

목록 11-4, 원격대면부 (MemberSearchJava) 

/* 

* Generated by Xdoclet Donot edit! 

*/ 

package sample, interfaces; 

/** 

* Remote interface for MemberSearch. 

*/ 

public interface MemberSearch extends javax. ejb. EJBObject { 

j%% 

* Business method 
*/ 

public sample, common. MemberDataHolder2 search 

(java. lang. String id) throws java. rmi. RemoteException ； 


목록 11-5. 홈대면부 (MemberSearchH()me.java) 

/* 

* Generated by Xdoclet Do not edit! 

*/ 

package samle. interfaces; 

/** 

* Home interface for MemberSearch. 

*/ 

public interface MemberSearchHome extends javax. ejb. EJBHome { 
public sta 社 c final String COMP_NAME= u java : comp/env/ejb/MemberSearch; 
public static final String JNDI_NAME= “ejb 그 MemberSearch” ； 
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public sample, interfaces. MemberSearch create0 

throws javax. ejb. CreateException, java. rmi. RemoteException; 


목록 11-6. EJB 서술자 (ejb-jar.xml) 

<?xml version: “1.0” encoding: “UTF-8” ?> 

<!DOCTYPE ejb-jar PUBLIC “-//Sun Microsystems, Inc. 

/ /DTDEnterprise JavaBeans 2.0//EN” ‘http:// 起 va.sun.rom/dtd/ej 노起 r_2_0.dtd” > 
<ejb-jar> 

<description><! [CDATA[No Description. ]] ></description> 
<display-name>Generated by Xdoclet</display-name> 

<enterprise-beans> 

<! — Session Beans —> 

〈 session 〉 

〈 descrip 仕 on〉<! [CDATA [Description for MemberSearch] ] ></description> 
<display-name>Name for MemberSearch</display-name> 

<ejb-name>MemberSearch</ejb-name> 

<home>sample. interfaces. MemberSearchHome</home> 

< remote> samp le. interfaces. MemberSearch</remote 〉 

<ejb-class>sample. ejb. MemberSearchBean</ejb-class> 
<session-type>Stateless</session-type> 
<transaction-type>Container</transaction-type> 
c/session 〉 

<! — 

To add session beans that you have deployment descriptor info for, 
add a file to your Xdoclet merge directory called entity-beans, xml 
that contains the <entity></entity>markup for those beans. 

—> 


<! — Entity Beans —> 

<! — 

To add entity beans that you have deployment descriptor info for, add 
a file to your Xdoclet merge directory called entity-beans, xml that 
contains the <entity></entity> markup for those beans. 

—> 


<! — Message Driven Beans —> 
<! — 
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To add message driven beans that you have deployment descriptor info 
for, add a file to your Xdoclet merge directory called message-driven-beans. xml 
that contains the <message-driven></message-driven> markup for those beans. 
—> 

</enterprise-beans 〉 

<! — Relationships — > 

<! — Assembly Descriptor — > 

〈 assembly-descriptor > 

<! — 

To add additional assembly descriptor info here, add a file to your 
Xdoclet merge directory called assembly-descriptor, xml that contains 
the assembly-descriptor></assembly-descriptor> markup. 

—> 

<!— finder permissions —> 

<!— transactions — > 

<! — finder transactions ——〉 

</assembly-descriptor 〉 

</ejb-jar> 


목록 11-7. EJB 서술자 (jboss.xml) 

<?xml version: “1.0” encoding: “UTF-8” ?> 

<!DOCTYPE jboss PUBLIC “_//Jboss//DTD JBOSS 3.0//EN” 

“http:/ / www.jboss.org/j2ee/dtd/jboss_3_0.dtd” > 

<jboss> 

<enterprise-beans> 

<! — 

To add beans that you have deployment descriptor info 
for, add a file to yor Xdoclet merge directory called jboss-bean 
s.xml that contains the <session></session>, <entity></entity> a 
nd <message-driven></message-driven> markup for beans. 

—> 


<session> 

<ejb-name>MemberSearch</ejb~name> 
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<jndi-name>ejb/MemberSearch</jndi-name> 

</session> 

</ enterprise-beans 〉 

< resou rce-managers 〉 

</resource-managers> 

</jboss> 


11.3.7. 종업원검색 Servlet 의 작성 

종업 원검 색 Servlet (MemberSearchServlet2. java ) 를 작성 한다 . 

[SampleChapll ] 를 오른쪽찰칵하고 [New] — [Other ] 를 선택 한다 . [Jboss-IDE] — 
[Web Components] ^ [HTTP Servlet ] 를 선택 하고 [Next] 단추를 찰칵한다 . 

[Package] 에 《 sample, web 》를 입 력 하고 [Name] 에 《 MemberSearchServlet2 》 
를 입 력한다 . [Modifiers] 에 [public] 가 선택 되 여있는가를 확인하고 [Super class] 에 
《 javax.servlet.http.HttpServlet 》 가 입력되여 있는가를 확인한다 . [Which method 
stubs would like to create ?] 에서는 [initOmethod ] 를 선택하고 [Which service 
method stubs would like to create ?] 에서는 [doPostOmethod ] 를 선택한 다음 [Fi 
nish] 단추를 찰칵한다(그림 11-20). 
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initO methods M 정 
doPo$t() methods 설정 


그림 11-20. Servlet 작성대화칸 

[MemberSearchServlet2. java] 가 작성 되여 편집기에 표시되므로 목록 11-8 의 코 
드를 입 력한다(굵은체 로 되 여있는 부분이 제 10 장의 코드에 대 한 추가 또는 수정할 코드 
이다 .). 종업원검색 Servlet 에서는 초기처리로서 종업원검색 EJB 의 홈대면부를 얻고 보유한다 . 
실행메쏘드 (doPostO ) 에서는 요청 (request ) 으로부터 얻은 종업원번호 (memberld ) 에 근거하 
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여 종업원검색 EJB(MemberSearchBean) 에 검색을 의뢰하며 검색이 성공한 경우(되돌이값인 
MemberDataHolder2 의 isErrorO 메쏘드가 허위 ) 종업원검색결과화면 (/memberSearchOK. jsp) 을 
현시 하고 오유가 발생 한 경 우 (MemberDataHolder2 의 isErrorO 메 쏘드가 참 ) 또는 례 
외 가 발생 한 경 우 종업 원검 색 오유화면 (/memberSearchNG. jsp) 을 현시 하도록 하는 처 
리를 진행하고있다 . 

목록 11-8. ggj^ja^iServlet(MemberSearchServlet2.iava) 

/* 

* 작성날자 : 200X/XX/XX 

* 

* Todo 가 생성된 파일의 형판을 변경시키려면 다음으로 건너뛰기 : 

* 창문 설정 Java 코드격식 코드형 판 

*/ 

package sample.web ； 


import javax.naming.Context ； 
import javax. naming. InitialContext ； 
import javax. rmi. PortableRemoteObject ； 
import javax. servlet, http. HttpServlet ； 

import javax. servlet. ServletException ； 
import javax. servlet. ServletConfig ； 
import java. io. IOException ； 
import java.util.Hashtable; 

import javax. servlet, http. HttpServletRequest : 
import javax. servlet, http. HttpServletResponse ； 

import sample, common. MemberDataHolder2; 
import sample, interfaces. MemberSearch ； 
import sample, interfaces. MemberSearchHome ； 


* Servlet Class 


* 9web. servlet name= “MemberSearchServlet2” 

* display-name= “Name for MemberSearchSevlet2 w 

* 9web. servlet-mapping url-pattern= “MemberSearchServlet2” 

* 9web. ejb-ref name= “ejb/MemberSearch” 


338 


錢變邊 錢變變繼繼繼 









세 tt 강 . JBoss - IDE 에 到 4J2EE 게방 


* type= “Stateless” 

* home= “sample, interfaces. MemberSearchHome” 

* remote= “sample, interfaces. MemberSearch” 

* description= “Reference to the MemberSearch EJB” 

* Sjboss. ejb-ref-jndi ref-name= w ejb/MemberSearch w 

* jndi-name= w ejb/MemberSearch w 
*/ 

public class MemberSearchServlet2 extends HttpServlet { 


private static final String ngPage = “/memberSearchNG. jsp” ; 
private static final String okPage = “/memberSearchOK. jsp” ; 


private MemberSearchHome home ； 


public void init(ServletConfig config) throws ServletException { 
super, init (config); 
try { 


Hashtable props = new HashtableO ； 

props. put(InitialContext. INITIAL_CONTEXT_FACTORY, 

“org. jnp. interfaces. NamingContextFactory); 
pros, put (Ini 社 alContext. PROVIDER_URL, “jnp: "127.0.0.1 ： 1099” ); 
Context context = new InitialContext (props) ； 

Object ref = context, lookup (MemberSearchHome. COMP_NAME) ； 
This, home = (MemberSearchHome) PortableRemoteObject. 
Narrow (ref, MemberSearchHome. class); 

} 

catch (Exception e) { 

throw new ServletException (e) ； 


protected void doPost(HttpServletRequest request, 

HttpServletResponse response) throws ServletException, IOExcep 仕 on { 

// 이행측 JSP 
String resultPage ； 
try { 

// 종업원 ID 얻기 

String memberld = request. getParameter( “memberld” ) ； 

// EJB 호출 
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MemberSearch remote = this. home, create0 ； 
MemberDataHolder2 mdh = remote, search (memberld) : 

// 결과판정 

if (Imdh.isErrorO) { 

resultPage = okPage ； 

} else { 

resultPage = ngPage ； 

} 

// 화면호줄 

request.setAttribute( “mdh” ， mdh); 
javax. servlet. RequestDispatcher dispatch = 

request. getRequestDispatcher(requestPage) ； 
dispatch. forward (request ， response) ； 

} 

catch (Exception e) { 

javax. servlet. RequestDispatcher dispatch = 
request. getRequestDispatcher(ngPage) ； 
dispatch. forward (request ， response) ； 


11.3.8. Servlet 와 관련된 파일의 생성 

Servlet 와 관련된 파일 (web.xml, jboss-web.xml) 은 XDoclet 를 생성한다 . 여기 
서는 XDoclet 의 정의를 진행한다 . [11.3.6. EJB 와 관련된 파일의 작성]과 절차상 차이 
는 없다 . 

패 키 지 열 람기 로 [SampleChapll] 을 오른쪽찰칵하고 [Properties] 을 선택 한다 . 
[SampleChapll 의 속성]에서 [XDoclet configurations] 를 선택하면 화면오른쪽에 
XDoclet 의 정의 화면이 나타난다 . 상부령역 에서 오른쪽찰칵하고 [Add] 단추를 선택하면 
[Configuration Name] 대화칸이 나타나는데 [Name] 에 《 Web 》 라고 입력하고 [OK] 
단추를 찰칵한다 . 이것으로 웨브용의 새로운 설정이 작성된다 . 

다음으로 작성된 [Web] 를 선택 하고 왼쪽아래 령역 에서 오른쪽찰칵하여 [Add 
Doclet] 를 선택한다 . [Choose an entry] 대 화칸이 나타나는데 [webdoclet] 를 선택하 
고 [OK] 단추를 찰칵한다 . 왼쪽아래령역에 [webdoclet] 가 나타나는것을 확인할수 있다 . 
[webdoclet] 를 선택하면 오른쪽령역 에 [Property] 가 현시 된 다 . [des®ir] 를 두번찰칵 
하여 현시되는 [Attribute Value] 대화칸에서 《 src/WEB-INF 》 라고 입력하고 [OK] 단 
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추를 찰칵한다 . 

다음으로 부과제를 추가한다 . 왼쪽아래 령역의 [webdoclet] 를 오른쪽찰칵하고 
[Add] 단추를 선택한다 . [Choose an entry] 대 화칸이 표시 되 므로 [fileset] 를 선택 하고 
[OK] 단추를 찰칵한다 . 왼쪽아래령역에 [webdoclet] 의 부과제로서 [fileset] 가 나타난 
다 . [fileset] 를 선택 하고 오른쪽령역 의 [dir] 에 《 src 》 를 입 력 하고 선택하며 [includes] 
에 《 **/*Servlet2. java 》 를 입 력 하고 선택 한다 . [excludes] 의 선택은 해제 한다 . 여 기 
서 [includes] 지정은 원천파일명의 마지막에 《 Servlet2.java 》 이 붙은것만을 Servlet 
로 인식시 키 기 위한것 이 다 . 

이제부터의 작업은 지금까지의 작업의 반복으로 된다 . [webdoclet] 를 오른쪽찰칵 
ᅳ [Add] 를 선택ᅳ목록에서 [deploymentdescriptor] 를 선택 ᅳ [OK] 를 찰칵한다 . 왼 
쪽아래 령 역 에서 [deploymentdescriptor] 를 선택 하고 오른쪽아래 령 역 에서 [Servletspec] 에 
《 2.3 》을 입 력하며 선택한다 . 여 기서 [destDir] 에 입 력하지 않는 리 유는 [webdoclet] 
에서 지정한 [destDir] 가 계승되 기때문이 다 . 부과제는 상위과제의 속성을 이 어받는다 . 

끝으로 [webdoclet] 를 오른쪽찰칵 — [Add] 를 선택—목록에서 [jbosswebxml] 를 
선택 — [OK] 를 찰칵한다 . 왼쪽아래 령 역 에서 [jbosswebxml] 을 선택 하고 오른쪽아래 령 
역의 [Version] 에 《 3.0 》을 입 력 하며 선택 한다 . 여기서도 마찬가지로 [destDir] 은 상 
위 과제 인 [webdoclet] 부터 계 승된 다 . 

이 상으로 설정 이 끝는다 . [OK] 단추를 찰칵하여 완료한다(그림 11-21). 
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XDoclet Configuration 


Java Build Path 
Java Compiler 
Javadoc Location 
Java Task Tags 
Project References 


XDoclet Configurations 


Define the XDoclet configuration available for generation 
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그림 11-21. 입력이 완성된 Xdoclet 정의대화칸 
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이제 Xdoclet 를 실행해 본다 . 패 키지열 람기 상에서 [SampleChapll] 를 오른쪽찰칵 
하고 [Run Xdoclet] 를 선택한다 . 

[SampleChapll/src’ WEB-INF/web.xml] , [SampleChapll’ src/ WEB-INF/ 
jboss-web.xml] 이 생성된다 . 패 키지 열 람기상에서 작성된 파일을 확인할수 없을 때 에 
는 F5 건을 누른다 . 줄력 된 파일의 내 용을 목록 11 _ 9 〜목륵 11 _ 10 에 표시 한다 . 

목록 11-9. Web 서술자 (web.xml) 

<?xml version: “1.0” encodings “UTF-8” ?> 

<!DOCTYPE web-app PUBLIC “-//Sun Microsystems, Inc. 

//DTD Web Application 2.3//EN” “http://java.sun.com/dtdAvetrapp_2_3.dtd” > 

<web~app> 

〈 distributable /〉 

<! — 

To use non Xdoclet filters, create a filters, xml file that 
Contains the additional filters (eg Sitemesh) and place it in your 
project’ s merge dir. Don’ t include filter-mappings in this file, 
Include them in a file called filter-mappings, xml and put that in 
the same directory. 

—> 


<! — 

To use non Xdoclet filter-mappings, create a filter-mappings, xml 
file that contains the additional filter-mappings and place it in your 
project’ s merge dir. 

—> 

<! — 

To use non Xdoclet listeners, create a listeners.xml file that contains 
the additional listeners and place it in your 
project’ s merge dir. 

—> 


<! — 

To use non Xdoclet servlets, create a servlets.xml file that 
contains the additional servlets (eg Struts) and place it in your 
Project’ s merge dir. Don’ t include servlet-mappings in this file, 
Include them in a file called servlet-mappings.xml and put that in 
the same directory. 
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〈 servlet 〉 

<servlet-name>MemberSearchServlet2</servlet-name> 
<display-name>Name for MemberSearchServlet2</display-name> 
<descrip 仕 on〉〈! [CDATA[Descrip 社 on for MemberSearchServlet2] ] > 
〈 /description 〉 

servlet-class>sample. web. MemberSearchServlet2</servlet-class> 
〈 /servlet 〉 

<servlet-mapping> 

<servlet-name>MemberSearchServlet2</servlet-name> 

<url-pattern>/MemberSearchServlet2</url-pattern> 

</servlet-mapping 〉 


<! — 

To specify mime mappings, crate a file named mime-mappings, xml, put 
it in your project’ s mergedir. 

Organize mime-mappings.xml following this DTD slice ： 

<! ELEMENT mime-mapping (extension, mime-type) > 

—> 

<! — 

To specify error pages, crate a file named error-pages. xml, 
put it in your project’ s mergedir. 

Organize error-pages.xml following this DTD slice ： 

<! ELEMENT error-pages ((error-code | exception-type), location) > 
—> 

<! — 

To add taglibs by xml, create a file called taglibs.xml and place 
it In your merge dir. 

—> 

<! — 

To set up security settings for your web app, create a file named 
Web-security.xml, put it in your project’ s mergedir. 

Organize web-security.xml following this DTD slice ： 


<!ELEMENT security-constraint (display-name?, 
web-resource-collection+, auth-constraint?, 
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user-data-constraint?) > 

<! ELEMENT web-resource-col lection (web-resource-name, 
description?, url-pattern*, http-method*)> 

<! ELEMENT web-resource-name (#PCDATA)> 

<! ELEMENT url-pattern (#PCDATA)> 

<! ELEMENT http-method (#PCDATA)> 

<! ELEMENT user-data-constraint (description?, transport-guarantee)> 


<! ELEMENT transport-guarantee (#PCDATA)> 


<! ELEMENT login-config (auth-method?, realm-name?, form-login-config?) > 


<! ELEMENT 
<! ELEMENT 
<! ELEMENT 
<! ELEMENT 
<! ELEMENT 


auth-method (#PCDATA)> 
realm-name (#PCDATA)> 

form-login-config (form-login-page, form-error-page) > 
form-login-page (#PCDATA)> 
form-error-page (#PCDATA)> 




> 


<ejb-ref> 

<description><! [CDATA{Reference to the MemberSearch EJB}]> 
〈 /description 〉 

<ejb-ref-name>ejb/MemberSearch</ejb-ref-name> 

<ejb-ref-type>Stateless</ejb-ref-type> 

<home>sample. interfaces. MemberSearchHome</home> 
<remote>sample. interfaces. MemberSearch</remote 〉 

</ejb-ref> 

</web~app> 


목록 11-10. Web 서술기 (jboss-web.xml) 

<?xml version: “1.0” encodings “UTF-8” ?> 

<!DOCTYPE jboss-web PUBLIC “-//Jboss/DTD Web Application 
2.3//EN” a http :// wwww. jboss.org/j2ee/dtd/jboss_web_3_2.dtd” > 

<jboss-web> 

<!— Resource Environment References —> 

<! — 

For additional resource-env-ref tags add a merge file called 
Jbossweb-resource-env-ref. xml 
—> 
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<!— Resource references —> 

<! — 

For additional resource-ref tags add a merge file called 
Jbossweb-resource-ref. xml 

—> 

<!— EJB References —> 

<! — 

For additional ejb-ref tags add a merge file called jbossweb-ejb-ref. xml 

—> 

< ejb-ref 〉 

<ejb-ref-name>ejb/MemberSearch</ejb-ref-name> 

<jndi-name>ejb/MemberSearch</jndi-name> 

</ejb-ref 〉 

<! — EJB Local References —> 

</jboss-web> 


11.3.9. 종업원검색결과화면 ( JSP ) 의 작성 

종업 원검 색 결과화면 (memberSearchOK. jsp) 을 작성 한다 . 

패 키지 열 람기상에서 [docroot] 를 오른쪽찰칵하고 [New] ᅳ [Other] 를 선택 한 다음 
[JBoss-IDE] —[Web Components] —[JSP Page] 를 선택 하며 [Next] 단추를 찰칵한다 . 
[Input or select parent folder] 에 《 SampleChapll/docroot 》 가 입 력 되 였음을 확 
인하고 [File name] 에 《 memberSearchOK. jsp 》 를 입 력 한 다음 [Finish] 단추를 찰칵 
한다(그림 11-22). 


BS 困 



SampSeChapll /docroot 
라고 입력 
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그림 11-22. JSP 작성대화칸 
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목록 11-11 과 같은 코드를 입 력한다(굵은체 로 된 부분이 제 10 장의 코드에 서 추가 
또는 수정한 코드이 다 . ) . 

목록 11-11. 종업원검색결과화면 (memberSearchOK.jsp) 

<%9page language^ “java” conten 竹 ype= “text/html;charset=UTF-8” 
pageEncoding= “UTF-8” %> 

<!DOCTYPE html PUBLIC “-//W3C//DTD XHTML 1.0 Transitional 
// EN ” “http : // www. w3. org/TR/xhtml 1/DTD/xhtml 1—transi 仕 onal. dtd’’ > 
<html> 

<head> 

〈 title 〉 종업 원검색결과 〈 /title 〉 

</head> 

<body bgcolor= “#FFFFFF” > 

<jsp : useBean id= “mdh” scope: “request” 

class= “sample, common. MemberDataHolder2” /> 

<div align= “center” > 

<h3> 종업원검색결과 </h3> 

<%= mdh. getMessageO %> 

(table width= “500” cellpadding= 10 align= “center” > 

<tr> 

<td width = “20%” bgcolor= “lightblue” 〉종업원번호 </td> 
<td width = “80%” bgcolor= “palegoldenrod” align= “left” > 
<%= mdh.getnameO %></td> 

</tr> 

<tr> 

<td width = “20%” bgcolor= “lightblue” > 종업원명 </td> 

<td width= “80%” bgcolor= “palegoldenrod” align= “left” > 

<%= mdh.getNameO %></td> 

</tr> 

<tr> 

<td width= “20%” bgcolor=” lightblue” 〉주소 </td> 

<td width=” 80%” bgcolor=” palegoldenrod” align=” left” > 
<%= mdh. get Address () %></td> 

</tr> 

〈 /table 〉 

</div> 

</body> 

</html> 
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11.3.10. 종업 원검 색 오유화면 ( JSP ) 의 작성 

종업 원검 색 오유화면 (memberSearchNG. jsp) 을 작성 한다 . 

종업원검색결과화면과 같은 절차로 작성 한다 . 출력서류철은 《 SampleChapll/ 
docroot 》 로 하고 파일명 은 《 memberSearchNG. jsp 》 라고 입 력 한다 . 서 류철 이 작성 된 
다음 목록 11-12 와 같이 코드를 입 력한다 . (굵은체 로 된 부분이 제 10 장의 코드에 서 추 
가 또는 수정할 코드이 다 . ) 

목록 11-12. 종업원검색오유화면 (memberSearchNG.jsp) 

<%9 page language=” java” contenttype=” text/html;charset=UTF-8” 
pageEncoding=” UTF-8” %〉 

<!DOCTYPE html PUBLIC “-//W3C/DTD XHTML 1.0 TransMonal//EN” 
w http：//www.w3.org/TR/xhtml 1/DTD/xhtml 1-transitional.dtd” > 
<html> 

<head> 

〈title〉 종업원검색 오유 </title> 

</head> 

<body bgcolor=” #FFFFFF” > 

<jsp : useBean id=” mdh” scope=” request” 

class=” sample, common. MemberDataHolder2 ,, /> 

<div align=” center” > 

<h3> 종업 원검 색 오유 </h3> 

<%= mdh. getMessageO %〉 

</div> 

</body> 

</html> 
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제4절. 패키지화 

JBoss-IDE 는 여 러 가지 보존파일의 패 키지화를 간단하게 하는 방법 을 제 공하고있다 . 
패키지의 형식에는 제한이 없다 . 

이 절 에서 는 패 키지화에 대 하여 설명한다 . 앞절에서는 실행 에 필요한 파일을 작성하 
였는데 J2EE 에서는 실행환경에 2 진파일을 배치할 때 보존 (*.jar ， *war ， *.ear ) 파일형 
식을 사용한다 . 그러나 보존파일을 적재한 형식으로 배치할수도 있다 . 이리한 방식은 정 
기 적 으로 갱 신되 는 정 적파일을 포함하는 경 우나 응용프로그람전체를 재배 치 하지 않고 부 
분적 으로 갱 신할 때 에 리용된다 . 

11.4.1. application . xml 의 작성 

.ear 파일에 필요하게 되는 [application.xml ] 을 작성한다 . [src/META-INF ] 의 
바로 아래 에 파일 을 작성 하고 목록 11-13 과 같이 코드를 입 력한다 . 

목록 11-13. 기업급응용프로그람서술기 (application.xml) 

<?xml version: “1.0” encoding: “UTF-8” ?> 

<!DOCTYPE application PUBLIC “-//Sun Microsystems, Inc. 

/ / DTD J2EE Applicatfonl. 3 / /EN” ‘http : // java. sun. com/dtd/applica 社 on_l_3. dtd” > 
〈 application 〉 

<display-name>SimpleApp</display-name> 

<module> 

<ejb>SimpleEJB. jar</ejb> 

</module> 

<module> 

<web> 

<web-uri>SimpleWeb2. war</web-uri> 

<context-root>/SimpleWeb2</contex 卜 root 〉 

</web> 

</module> 

〈 /application 〉 


11.4.2. EJB 요소의 패키지화 

우선 EJB 를 패 키지화한다 . 패 키지열 람기상에서 [SampleChapll ] 을 오른쪽찰칵하 
고 [Properties ] 을 선택 한다 . [SampleChapll Property ] 대 화칸이 현시되 는데 여 기서 
[Packaging Configurations ] 를 선택한다(그림 11-23). 화면오른쪽에서 오른쪽찰칵하 
고 [Add Archive] 를 선택한다 . 
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I 호 1C 


Info 

Beanlnfo Path 
Builders 

XDoclet Configuration 
Java Build Path 
Java Compiler 
Javadoc Location 
Java Task Tags 
Project References 


Packaging Configurations 


Define the packaging configurations available for generation 



Cancel 


그림 11-23. 패키지화정의대화칸 

[Archive Edition] 대 화칸이 현시 되 면 [Name] 에 《 SimpleEJB. jar 》를 입 력 하고 
[OK] 단추를 찰칵한다 (그림 11-24). 



SimpIsEJBjar 라고 입력 


그림 11-24. 보존파일명지 정대화칸 

작성된 [SampleEJB. jar] 를 생성 하기 위 한 정의 에 파일 또는 서류철을 추가하여 야 
한다 . (지금까지 작성해놓은 클라스파일은 [SampleChapll/bin] 서류철에 들어 있다 .) 
클라스파일을 다음과 같이 추가한다 . 화면오른쪽의 [SimpleEJB.jar] 상에서 오른쪽찰칵하고 
[Add Folder] 를 선택한다 . [Folder Selection] 대화칸이 표시되기때문에 [Project Folder] 
를 누른다 . 그러면 [Select a Folder] 대화칸이 표시된다 . 《 /SampleChapll/bin 》 을 선택 
하고 [OK] 단추를 찰칵한다 (그림 11-25). 
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[ho 田 s 표 a hldcr 



/SampbChapll/bin 
을 선택 


그림 11-25. 서류철지정대화칸 

[SampleChapl 1/bin] 서류철을 추가했는데 이것을 그대로 리용하면 

[SampleChapll/bin] 아래 에 있는 클라스가 다 포함되 게 되 기 때 문에 EJB 로서 는 필요 
없는 클라스파일을 제거해야 한다 . 그래서 [includes] 에 《 sample/ejb/*.class,sample 
/interfaces/*.class,sample/common/*.class 》 라고 입력하고 [OK ] 단추를 찰칵한다 . 이 
렇게 하여 sample.ejb 패키지와 sample.interfaces 패키지， sample.common 패키지 안의 클 
라스만을 포함하도록 한다 . 지정 할것 이 여 러개 일 때는 반점으로 구분한다(그림 11-26). 


sample/0jb/*.class. 

■sampl0/int0rfac8s 

/♦.class. 

sample / co_cm/，,class 
라고입력 


Folder Selection mm 


Choose a folder (e 的 her in workspace or external) 


Foider /SampleChapl t Project FoEder 


External Folder 

Include: 

ces/* .ctass,sample/cormmon/*.c lass 

Exclude: 


Prefix: 



OK Cancel 


그림 11-26. 서류철추가대화칸 

다음으로 EJB 배 치서술기 (ejb-jar.xml ， jboss.xml ) 를 추가한다 . [SampleChapll 
Properties ] 에서 [SampleEJB. jar ] 를 오른쪽찰칵하고 [Add File ] 를 선택한다 . [File S 
election ] 대화칸이 현시되면 [Project File ] 를 누른다 . [Select a File ] 대화칸이 현시되 
면 《 SampleChapll/src/META-INF/ejb-jar.xml 》 를 입력 또는 선택하고 [OK] 단추 
를 찰칵한다(그림 11-27). 
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Select a file resource 
▽ I 는 SampleChap 11 
I> [3- bfn 
|> g? doc root 
I> @ ， SimpleWeb2 
V &SfC 

자 & META-INF 
t> Bl application .xml 
]> ® ejb-jaf.xml 
分 j^i jboss.xml 
t> IS- sample 
t> © WEB-INF 
jij xdoclet-byild.xml 

- ― I /SamplaChapll/src/ 

/SampleChapll/src/META-INF/ejb-jar.xmi - METAHNF/ejHar xml 

- 1 — — 1 이라고 입력 또는 Mm 

OK Cancel 


그림 11-27. 파일선택대화칸 

[ejb-jar.xml] 를 [SimpleEJB.jar] 안의 어디에 배치하겠는가를 지정한다 . [ejb-jar.xml] 
는 EJB 패키지의 [META-INF] 에 배치되기때문에 [Prefix] 에 《 META-INF 》 를 입 력 하고 
[OK] 단추를 찰칵한다 (그림 11-28). 



META 쌔 F 

라고 입력 


그림 11-28. 파일추가대화칸 

다음으로 [jboss.xml] 를 추가한다 . [ejb-jar. xml] 과 같은 절 차로 추가를 진행한다 . 
[SampleChapll Property] 에서 [SimpleEJB. jar] 를 오른쪽찰칵하고 [Add File] 를 선 
택한다 . 다음 [Project File] 를 누르고 [SampleChapll/src/META-INF/jboss.xml] 
를 입 력 또는 선택 한 다음 [OK] 를 찰칵한다 . [Prefix] 에 《 META-INF 》 를 입 력 하고 
[OK] 단추를 찰칵한다 . 이것 으로 [SimpleEJB. jar] 를 생성하기 위한 정의는 끝난다 . 
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터 B 의 족시배치 

표피를 개발하는 과정중에 다른 응용봉사기와 다른 점 이 있다. 그것은 대용체파 
일 을 일 부러 생 성 하지 않아도 된 다는것 이 다. WebLogic 에 서 는 ejbc 지 령， 
WebSphere 에서는 AAT (응용프로그람아쨈블리도구)에 의 하여 대용체파일의 생성을 
개 발자가 책 임지 고 진행하지 만 JBoss 에서는 JBoss 응용봉사기 가 배 치시 에 자동적 으로 
해준다. 이것을 즉시배치 (hot deployment ) 라고 하며 개발의 생산성을 향상시킨다. 

즉시배치는 JBoss 봉사기의 deploy 등록부에 jar (또는 war , ear ) 파일을 복사만하 
고 봉사기의 재시동이 필요없다. 정상적인 개발과정에 오유수정문을 한행 삽입하고 
싶거나 약간의 수정을 가하고 싶다고 할때가 자주 제기된다. 그때마다 봉사기의 재시 
동이나 배치도구 등을 사용하여 배치를 진행한다면 생산성을 저하시키게 된다. 즉시 
배치는 생산성향상에 쓸모가 있는 기능이다. 


11.4.3. EJB 의뢰기 용파일의 패키지 화 

여 기서는 EJB 의 뢰 기 용으로 배 포하기 위한 보존파일의 패 키지화를 진행한다. 이 보 
존파일에는 EJB 기준대면부， EJB 원격대면부，검사자료보유클라스가 포함된다. 이 장의 실 
례응용프로그람에서 EJB 의뢰기는 Servlet ( MemberSearchServlet 2. java ) 를 나타난다. 

정 의방법은 EJB 요소의 패키지화와 동일하다. [SampleChapll Property ] 에서 
[Packaging Configurations ] 를 선택 하고 화면오른쪽에서 오른쪽찰칵하여 [Add Archive ] 
를 선택 한다. [Archive Edition ] 대 화칸이 나타나면 [ Name ] 에《 SimpleEJBClient . jar 》 를 
입 력 하고 [ OK ] 단추를 찰칵한다. 

다음으로 클라스파일을 추가한다. [ SimpleEJBClient . jar ] 를 오른쪽찰칵하고 [Add 
Folder ] 를 선택 한다. [Folder Selection ] 대화칸이 나타나는데 여기서 [Project Fold 
er ] 를 누르고 《 SampleChapll / bin 》 을 입 력 또는 선택 한 다음 [ OK ] 단추를 찰칵한다. 
[ Includes ] 에 《 sample / interfaces /*, class , sample / common /*, class 》를 입 력 하고 
[ OK ] 단추를 찰칵한다. 

이것으로 [ SampleEJBClient . jar ] 를 생성하기 위한 정의 가 끝난다. 

11.4.4. Web 요소의 패키지화 

Web 요소의 패 키지 화를 진행한다. 정의방법 은 EJB 요소의 패 키지 화와 동일하다. 패 
키지열 람기 에서 [ SampleChapll ] 를 오른쪽찰칵하고 [ Properties ] 을 선택한 다음 
[SampleChapll Property ] 에 서 [Packaging Configurations ] 를 선택한다. 화면오른 
쪽에서 오른쪽찰칵하고 [Add Archive ] 를 선택 하면 [Archive Edition ] 대 화칸이 나타나 
는데 [ Name ] 에 《 SimpleWeb 2. war 》 를 입 력 하고 [ OK ] 단추를 찰칵한다. 
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다음으로 클라스과일을 추가한다 . [SimpleWeb2.war] 를 오른쪽찰칵하고 [Add Fo 
lder] 를 선택 한다 . [Folder Selection] 대 화칸이 현시 되 면 [Project Folder] 를 누르고 
《 SampleChapll/bin 》을 입력 또는 선택하고 [OK] 단추를 찰칵한다 . [Includes] 에 
《 sample/web/*.class 》 를 입력하고 [Prefix] 에《 WEB-INF/classes 》 를 입력한 다 
음 [OK] 단추를 찰칵한다 . 

다음으로 Web 배치서술기를 추가한다 . 우와 마찬가지로 [SimpleWeb2.war] 를 오 
른쪽찰칵하고 [Add Folder] 를 선택 한다 . [Folder Selection] 대화칸이 현시되면 [Proj 
ect Folder] 를 누르고 《 SampleChapll/src/WEB-INF 》 를 입 력 또는 선택한 다음 [O 
K] 단추를 찰칵한다 . 

JSP, HTML 를 추가한다 . [Simpleweb2.war] 를 오른쪽찰칵하고 [Add Folder] 
를 선택 한다 . [Folder Selection] 대 화칸이 현시 되 면 [Project Folder] 를 누르고 《Sa 
mpleChapll/docroot 》 를 입력 또는 선택한 다음 [OK] 단추를 찰칵한다 . [Folder 
Selection] 에서 는 기 정 설정 으로 하고 [OK] 단추를 찰칵한다 . 

마지막으로 EJB 의뢰기용 JAR 를 추가한다 . 현단계에서는 [SimpleEJBClient.jar] 는 
아직 작성 되 여있지 않지 만 정 의 로서 지 정할수는 있 다 . [SimpleWeb2.war] 를 오른쪽찰 
칵하고 [Add File] 를 선택한다 . [Project File] 를 누르면 [Select a File] 대 화칸이 나 
타난다 . [Select a file resource] 에 [SimpleEJBClient. jar] 는 표시 되 여 있지 않지 만 
화면아래의 입력마당에 《 /SampleChapll/SimpleEJBClient.jar 》 라고 입력한 다음 
[OK] 단추를 찰칵한다 (그림 11-29). 


r S ample C hap IIP roperty 


: 成：섶 : 


Se『ect a file resource 
며 t 7 S am pleCh ap 11 
t> O? bin 
t> ^ doc root 
t> &SimpleWeb2 



■ xdoclet-build.xnnr 


/SampleChap11 /S im pte E J BGI ient.jar 


Cancel 


/SampleChapll/Simple 
EJBCIianqar 라고 입력 



그림 11-29. 파일지정대화칸 


錢變邊 0 變變©繼鹽 


353 






















H 너•參於경 Eclipse 


[Prefix] 에 《 WEB-INF/lib 》를 입 력 하고 [OK] 단추를 찰칵한다 . 이 것 으로 
[SimpleWeb2.war] 를 생성하기 위한 정의 가 끝난다 . 

11.4.5. 기업급응용프로그람의 패키지화 

기 업 급응용프로그람을 패 키지화한다 . 이것도 지 금까지 하던 패 키지화방법과 같다 . 

패 키지열 람기 에서 [SampleChapll] 을 오른쪽찰칵하고 [Properties] 을 선택한다 . [Pac 
kaging Configurations] 를 선택하고 화면오른쪽에서 오른쪽찰칵하며 [Add Archive] 
를 선택한다 . 

[Archive Edition] 대 화칸이 현시 되 면 [Name] 에 《 SimpleApp.ear 》를 입 력 하고 
[OK] 단추를 찰칵한다 . 다음으로 [SimpleApp.ear] 를 오른쪽찰칵하고 [Add File] 를 선 
택 한다 . [File Selection] 대화칸이 나타나면 [Project File] 를 누르고 《SampleChapl 
1/src/META-INF/application.xml 》 을 입 력 또는 선택한 다음 [OK] 단추를 찰칵한다 . 
[Prefix] 에 《 META-INF 》를 입력하고 [OK] 를 찰칵한다 . 같은 절차로 
《 /SampleChapll/SimpleEJB. jar 》 와 《 /SampleChapll/SimpleWeb2. war 》 -1- 추 
가한다 . 이 2 개의 파일은 아직 작성되 여있는 상태가 아니므로 직접 입 력을 해 야 한다 . 2 
개 의 파일 에 대 하여 [Prefix] 에 는 아무것 도 입 력하지 않는다 . 

이상으로 모든 설정 이 끝났다 . 결과 [Packaging Configurations] 는 그림 11-30 과 
같이 설정 되 였 다 . [OK] 단추를 찰칵하고 설정 을 보관해 놓는다 . 
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11.4.6. 패키지화의 실행 

지금까지 진행해온 설정내용으로 패키지화를 진행한다 . 패키지열람기상에서 
[SampleChapll] 을 오른쪽찰칵하고 [Run Packaging] 를 선택 하면 패 키지 화가 시 작된 
다 . 조종탁보기에는 그림 11-31 과 같이 내용들이 나타난다 . 


Tasks S Console 然 

懸 效 

£1 &. 

면 ■ᄆ □ 

<finished> SampEeGhapll packaging-build xml [Ant builder] /KUT/j2sdk/bin/javaw e^e 。 004/"10/15 5:42:48) 





N1D036: 

[jar] Building jar: IKUT /wo:kspace/SampIeChap 1 l/Sinnp]sWeb2.war 

NI0063: 

[jar] Building jar: /KlJ17woiitspace/SanipleChap11/SimpleApp.ear 
jsneratfon: 

B_ SUCCESSFUL 

Total time: 891 milliseconds 

A 

三 




^1 



그림 11-31. 패키지화실행결과 

패키지열람기로 파일이 생성되였는가를 확인해본다 . 그림 11-32 를 보면 
[SimpleApp. ear ] ， [SimpleEJB. jar ] ， [SimpleEJBClient. jar ] ， [SimpleWeb2. war] 
의 4 개파일이 생성된것을 볼수 있다 . 


發’ Hierarchy 

° □ 

수 타 % 

B ■할 ▼ 


▽ 以 SampleChapll 


t> iJsrc {WEE} 

I> 었 jRE System Library [jdkl.6-0] 

BA org j bos s .ide.ec I i psejdt.c ore. c I as s p ath .j ； 
I> &S:impleWeb2 
I> 연? doc root 

Hi SiimpleApp.ear 

■ SiimpleE JB-jar 

ill SiimpleEJEClient.jar 
El Simp1eWeb2.war 
Hj packaging-build.xml 

■ xdodet-buildxml 


그림 11-32. 생성된 보존파일 
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제5절. 배치와 실행 

작성 한 종업 원검색응용프로그람을 실행해본다. 실행 하기 위 해서는 응용프로그람을 
JBoss 봉사기에 배치하고 JBoss 봉사기를 기동해야 한다. 여기서는 JBoss-IDE 의 기능을 
써서 종업 원검 색응용프로그람의 배 치방법 에 대 하여 설명한다. 

11.5.1. 기업급응용프로그람의 배치 

배 치 방법은 다음과 같다. 패키지열 람기 에서 배 치하려는 파일(여기서는 
[ SimpleApp . ear ]) 을 오른쪽찰칵하고 [ Deployment ] —[Deploy To ] 를 선택 한 

다. [*. ear ] 파일외 에 [*. jar ] 파일， [*. war ] 파일에 의한 배 치도 가능하다. [Target Ch 
oise ] 대 화칸이 현시 되 면 [ JBoss 3. 2. 5 ( all ) [ file : / KUT / jboss - 3. 2. 5/ server / all/depl 
oy /]] 를 선택하고 [ OK ] 단추를 찰칵한다(그림 11-33). 여기서는 《- call 》 추가선택으 
로 JBoss 를 기동시킴으로 [ JBoss 3.2.5( all )] 를 선택한다. 



그림 11-33. JBoss 봉사기설정대화칸 

이상으로 배치가 끝난다. 배치가 끝나면 배치된 파일의 아이콘이 변한다(그림 11-34). 
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^聲浴 Hierarchy 

ᄆ 因 

수과 싫 

B ， ▼ 


▽ 給 今 SampleChapll 
1> 변 src (WEE) 


|> _URE System Library [jdkl.6.0] 
E&orgJboss.ide.eclipseJdT.core.dasspathji 
t> &5impleWeb2 
t> & doc root 


SimpieApp.ear 


■ SimpleEJB.jar 
SimpleE JSCientJar 

_ SimpleWeb2.war 

■ pack aging-build .xml 

■ xdodet-build.xml 


그림 11-34. 배치된 파일 

배 치 해제를 진행하려는 경우에는 패키지열 람기 에서 [ SimpleApp . ear ] 를 오른쪽찰 
칵하고 [ Deployment ] —[ Undeploy ] 를 선택 하면 된다. 또한 재배 치 를 할 때는 
[ Deployment ] ᅳ [ Redeploy ] 를 선택한다. 배치，배치해제를 봉사기의 기동상태에서 
진행하면 조종탁보기에 통보가 출력되기때문에 확인할수 있다. 

11.5.2. 기업급응용프로그람의 실행 

우선 JBoss 봉사기를 기동한다. 여기서 다시한번 JBoss 봉사기의 기동추가선택으로 《-c 
all 》 이 지정되여있는가를 확인하다. 이것이 지정되여있지 않으면 EJB 을 실행할수 없다. 

JBoss 봉사기가 기동되면 열람기를 기동시 켜 《 http : // localhost : 8080/ 

SimpleWeb 2» 라고 입 력 한다. 성 공하면 그림 11-35 가 현시 된다. 


오!위 a 신!一«내나염방기 




그림 11-35. 종업원검색화면 
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종업원검색화면에서 종업원번호에《111》라고 입력하고 [검색실행] 단추를 찰칵한다. 
검색처리가 진행되고 그림 11-36 과 같이 종업원검색결과화면이 현시된다. 



그림 11-36. 종업원검색결과화면 


열람기의 되돌이단추를 눌러 다시 종업원검색화면을 현시하고 이번에는《333》을 입 
력하고 [검색 실행]단추를 찰칵한다. 그러면 그림 11-37 과 같은 종업 원검 색 오유화면 이 
현시된다. 이상으로 종업원검색 응용프로그람의 실행을 확인할수 있다. 



그림 11-37. 종업원검색오유화면 


11.5.3. 오유수정 

오유수정 방법 에 대 하여 설명 한다. 여 기서 JBoss 봉사기를 기동하고있을 때 에는 정지 
시 켜야 한다. 응용프로그람의 실행시에 원천코드상에서 응용프로그람을 일시 정지하고 
그때의 상태를 한 걸음씩 확인할수 있다. 그렇게 하려면 JBoss 봉사기상에 배치된 2전파 
일 (*. ear 파일， *. war 파일 등)과 원천코드를 대 응시 켜 야 한다. 왜 냐하면 2진파일 에 는 원 
천이 포함되지 않았기때문이다. 
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원천파일의 위치를 Eclipse 에서 지정한다. Eclipse 의 차림표띠에서 [ Run ] ᅳ 
[ Debug ] 을 선택 한다. 다음으로 [ Configurations ] 에서 [ JBoss 3. 2. 5] 를 선택 하고 화면 
오른쪽에 서 [ Source ] 래 브를 찰칵한다(그림 11-38). 그리 고 [ Add ] 단추를 찰칵한다. 



그림 11-38. 원천서류철지정 

[Add source ] 대 화칸이 현시 되 면 [Java Projects ] 를 선택 하고 [ OK ] 단추를 찰칵한 
다. [Select Pro jet ] 대화칸이 현시된다. 원천파일을 추가하려는 프로젝트(여기서는 
[ SampleChapll ]) 를 선택하고 [ OK ] 단추를 찰칵한다. 이상으로 원천파일지정이 끝난 
다. [ Apply ] 를 찰칵하고 설정을 보존한다. 

다음으로 멈춤점을 설정한다. 실례로 종업원검색 Servlet 의 오유수정을 진행하기로 
한다. [ MemberSearchServlet 2. java ] 를 편집 기 로 연다. 실행 을 일시 정지 하려 는 행 의 
왼쪽끝에 마우스지 시 자를 이 동시 켜 두번찰칵 또는 오른쪽찰칵하여 [Toggle Line 
Breakpoint ] 를 설 정한다 (그림 11-39). 
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멈춤점의 설정 


그림 11-39. 멈춤점의 지정 

JBoss 봉사기 를 기 동한다. 차림 표띠 에 서 [ Run ] ᅳ [ Debug ] 을 선택하여 현시 되 는 대 
화칸에 서 [ Debug ] 을 누르면 오유수정방식 으로 기 동된 다. 

봉사기가 기동하면 열람기를 열고 《 http :// localhost :8080/ SimpleWeb 2 》를 입 
력한다. 앞에서 실행했을 때와 마찬가지로 [종업원번히에 《111》를 입력하고 [검색실 
행]단추를 찰칵한다. Eclipse 에서 투시절환대 화칸이 현시된다. 이것은 방금 지정 한 원천 
코드상에 서 오유수정 를 하기 위하여 [ Debug ] 투시 를 열 겠는가를 문의하는 대 화칸이 므로 
[ Yes ] 를 찰칵한다. 
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제12장. SWT 를 리용한 응용프로그람개발 

제1절. SWT 의 개념 

Eclipse 는 Swing 을 사용한 다른 Java 응용프로그람과 대 비 하면 한결 빠르게 동작 
한다. 제1장에서도 언급되였지만 그것은 SWT (Standard Widget Toolkit : 표준부품도구 
묶음)라고 부르는 GUI 작성용의 도구묶음을 리용하고있기때문이다. SWT 는 실행하고있 
는 조작체계가 가지고있는 본래의 사용자대면에 직접，그리고 간단히 접근할수 있기때문 
에 고속으로 그림그리 기 가 가능하다. Java 가상기계 에 만 고유하여 이식성 이 높은 반면에 
내부처리가 복잡해지는 Java Swing 을 사용한 응용프로그람에 비하면 동작이 실지로 빠 
르다. 

SWT 를 리 용하기 위한 API 는 환경 에 관계 없 이 공통이 므로 각 조작체 계 의 기 정 사용 
자대 면 에 다 접 근할수 있 다. 조작체 계 자체 의 차이 는 Java 가상기 계 에 의해 무시 되 고 
Windows 의 경우는 DLL 파일， Linux 에서는 so 파일 등의 기정서고를 경유하여 실행되 
기때문에 기본적으로 프로그람을 개발할 때 조작체계의 차이를 의식할 필요가 없다. 그 
래서 원천코드나 클라스파일의 준위에서는 가동기반에 의존하지 않는다고 할수 있다. 그 
리고 SWT 를 사용하면 Windows 환경에서는 ActiveX 의 리용 등 각 조작체계의 고유한 
기술의 리용도 가능하다. 

허 가는 CPL(Common Public License : 일 반공개 허 가)이 적 용되 므로 가능하다. 
SWT 를 리용하여 응용프로그람을 작성하였다고 해도 원천코드를 공개할 의무가 없으며 
개발한 응용프로그람에 대해서 자체의 사용허가권을 적용할수 있다. 


제2절. SWT 응용프로그람작성 

12.2.1. 견본응용프로그람의 개요 

간단한 응용프로그람을 만들어 보면서 SWT 의 사용법을 보기로 한다. 

이 장에 서 작성하는것 은 달력 을 표현하는 응용프로그람이다. 기 동하면 그림 12-1 과 
같은 화면이 현시된다. 단추를 눌러 전달，다음달의 표시가 가능하고 월을 바꾸면 현시 
년월을 나타내는 본문칸도 같이 변경된다. 
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전달로이 1 ti 달 


표시하고 있는 년.월 


다옴달 


i 균려 알자 


그림 12-1. 달력응용프로그람의 대면부 

이 장의 마지막에 SWT 와 Swing 의 통합에 대해 간단히 취급한다. 우에서 본 
SWT 응용프로그람을 작성하고 거기에 Swing 의 JTree 부품을 추가한다(그림 12-2). 
JTree 에서 년과 월을 표시하고 이것을 두번 찰칵하면 지정한 달의 달력으로 변한다. 



SWT 


Swing JScrollPatie 
JTree 


두번 찰각하면 지 점한 년월의 달력 몰 표시 
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그림 12-2. Swing 부품의 통합 
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12.2.2. 프로젝트의 작성과 개발환경의 설정 
먼저 프로젝트를 작성한다. 

차림 표띠 에 서 [ File ] —[ New ] —[ Project ] 를 선택 한다. 새 로운 프로젝 트를 작성 하기 
위한 대 화칸이 현시 되 면 [Java Project ] 를 선택 하고 다음으로 넘어 간다. 그림 12-3 의 
대 화칸이 현시 되 는데 [Project name ] 에 는 《 SampleChapl 2 》를 입 력 하고 [ Finish ] 
를 찰칵한다. 



SampleChapl 2 
라고 입 력 


그림 12-3. 프로젝트작성대화칸 

다음 SWT 의 Java 서고 《 swt . jar 》 를 클라스경로에 추가한다. [3.1.4 프로젝트속 
성] 에서 설명한것 처 럼 클라스경 로변수를 설정하여 프로젝트작성경 로에 변수이 름을 붙여 
놓는다. 차림 표띠 의 [ Window ] ᅳ [ Preference ] 를 선택 하여 [ Preference ] 대 화칸을 열 
고 [ Java ] —[Build Path )] —[Classpath Variables ] 로 전개 한다. [ New ] 를 누르면 
[New Variable Entry ] 대화칸이 현시된다. 변수이름에 《 SWT _ LIB 》 ， 경로는 
《/ eclipse / plugins / org . eclipse . swt _3. 0.1/ swt . jar 》 라고 입력한 다음 [ OK ] 를 찰 
칵한다(그림 12-4). 

동시에 SWT 의 원천파일경로에도 변수이름을 붙여놓는다. 이렇게 하면 개발을 하는 
과정에 아주 편리하다. 《 SWT _ LIB 》 의 경우와 똑같이 [Classpath Variable ] 화면에서 
[ New ] 를 눌러 변수이름에는 《 SWT _ SRC 》를， 경로는《 / eclipse / plugins / 
org . eclipse , platform . source _3. 0.1/ src / org . eclipse , swt _3. 0.1/ swtsrc . zip 》 로 설 
정 한다. 
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SWTJJB 라고 입 력 
,swt. jar 의 경로입력 


그림 12-4. 클라스경로변수의 새로 작성 

계속하여 작성한 이러한 변수를 프로젝트작성경로에 추가한다. [Properties for 
SampleChapl 2] 대화칸의 [Java Build Path ] 를 선택하고 [ Libraries ] 래브에서 [Add 
Variable …]를 찰칵한다. SWT _ LIB 를 선택하고 [ OK ] 를 찰칵한다(그림 12-5). 


SWT-LIB 룔 

선 M 




Info 

Builders 

Java Build Path 


Java Compiler 
Javadoc Location 
Java Task Tags 
Project References 


Java Build Path 


& Source | k3 Projects SA Libraries 



Select variables to add to build path: 




| 妙分 Order and Export | 


I ᅴ o|x 


• o> « 


Add JARs... 


&ECLIPSEJHOME - /eclipse 


及 그 RE_LIB - 


&JRE.SRC - (empty) 


&JRE_SRCROOT - (empty) 


^ juni 1 - : ■三 ._ 

정 ^^^^^ 병 ^^ ■지 

때 1 1 

上 j 


Configure Variables... I 


Add External JARs", 


변수추가단추틀 
누분다. 


Add Library... 
Add Class Folder... 


Edit... 


Remove 


OK | Cancel 


Default output folder: 

| SampleChap 12/bin Browse... I 



그림 12-5. Java 작성경로에 변수 SWTJJB 의 추가 
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다음 작성된 SWT_LIB 를 펼치 고 [Source attachment] 를 표시 한다. 이것을 선택 한 
상태에서 [Edit] 를 찰칵하면 [Source Attachment Configuration] 대화칸이 나온다. 
여 기서 [Variable] 를 찰칵하고 [Variable Selection] 대 화칸에서 SWT_SRC 를 설정한 
다. 이 상 SWT 응용프로그람을 작성할수 있는 환경 을 마련하였 다. 

그리 고 SWT 응용프로그람의 실행시 에는 공유서고 (DLL 파일)에 경 로를 지정 해 두는 
것이 필요하다. 이것은 필요한 DLL 파일을 프로젝트등록부에 복사하는것으로도 되지만 
(/ eclipse/plugins/org. eclipse. swt_3.0.1/"./swt-awt 

-win32-3063. dll 을 프로젝트등륵부 eclipse/workspace/SampleChapl2 에 복사한 
다.) 이 책에서는 실행시에 VM 인수를 설정하는 방법으로 이것을 실현한다. 구체적인 방법 
은 다음절에서 설명하였다. 

12.2.3. 창문의 현시 

Shell 을 생 성하여 가장 간단한 SWT 응용프로그람을 작성한다. 먼저 주클라스를 작 
성 한다. [Package Explorer] 보기 에 서 [src] 등록부를 선택 하여 오른쪽단추를 찰칵하고 
[New]- 사! Class] 를 선택하면 [New Java Class] 대 화칸이 현시된다. [Package] 에 (s 
ample, swt), [Name] 에《 CalendarMain 》을 입 력 한다. [Public static void main(S 
tring[] args)] 의 검 사칸을 설정 한다(그림 12-6). 



sample, swt 룔 입 력 


CalendarMain 을 입 력 


이 항목을 성 정 


그림 12-6. 주클라스의 작성 
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창문만을 현시하는 SWT 응용프로그람을 작성한다. 우선 Main 메 쏘드를 목록 12-1 
과 같이 작성한다. 


목록 12-1. 창문을 표시하는 SWT 응용프로그람 

import org . eclipse . swt . widgets . Display ； 
import org . eclipse , swt . widgets . Shell ； 

public class CalendarMain { 


public static void main (String [] args ) { 


Display display = new Display 0 ； 

Shell shell = new Shell ( display ); 

. . . (1) 

• • • (2) 

shell , open (); 

... (3) 

while (! shel 1. isDisposed 0) { 

if (! display . readAndDispatch () ) 
display , sleep 0 ； 

i 

... (4) 

j 

display , dispose 0 ; 

... (5) 


이제 SWT 응용프로그람을 순서대로 따라가면서 구체적으로 보기로 한다. 먼저 전체 
스레 드를 관리하는 Display 구체 례 를 작성한다 (1). 그 다음 Shell 의 구체 례 를 작성 하고 
(2) open 메쏘드를 호출한다 (3). Shell 은 Swing 의 JFrame 에 해당하는 창문이다. 이 
Shell 이 사용자의 조작에 의 해 닫길 때 ( isDisposed 메 쏘드가 참이 될 때 )까지 while 순 
환을 반복한다 (4). 창문이 닫기면 생성했던 Display 구체례를 처분하고 끝낸다 (5). 즉 
Java 가상기 계 의 자동기 억 관리 (garvage collection ) 에 맡기 는것 이 아니 라 Display 구체 례 
를 명시적으로 처분할 필요가 있는것이다. 그것은 SWT 가 순수 Java 가 아니기때문이다. 

그러면 실행시켜 본다. [Package Explorer ] 에서 《 CalendarMain 》 클라스를 선택 
한 상태에서 차림표띠에서 [ Run ] ᅳ [ Run ] 을 선택하면 실행대화칸이 현시된다. 화면왼 
쪽의 [ Configuration ] 에서 [Java Application ] 을 선택하고 [ New ] 를 찰칵하면 
[ Main ] 태브의 필요한 항목이 자동적 으로 입 력되 여있다(그림 12-7). 
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자름적으로 설정 
되여 있음 


그림 12-7. 기동구성의 설정 

계속하여 [ Arguments ] 래브를 선택한다. [VM arguments ] 에《 - Djava . library . path = 
/ eclipse / plugins / org . eclipse . swt _3. 0.1》를 입력한다. 이렇게 하여 지정한 서류철에 
있는 공유서고의 경로가 설정된다(그림 12-8). 



실행에 릴요한 
서고에 경로률 
지정 



그림 12-8. VM arguments 의 설정 
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[Run] 를 찰칵하면 그림 12-9 와 같은 창문만 현시하는 SWT 응용프로그람이 실행된다. 



그림 12-9. 창문을 현시 


12.2.4. GUI 부품의 작성 

작성한 창문에 부분품들을 차례로 추가해나간다. 추가하려는 부분품들을 그림 
12-10 과 같이 배 치 한다. 복합체 (Composite) 는 여 러 개의 부품을 내부에 배 치 하기 위 한 
부품이다. (Swing 에서 말하는 JPanel 에 대응된다.) 



5un 

| Mon 

Tue 

Wed 

Thu 

| Fri | 

| Sat | 
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/ 달력조 # 
composite 


Composite 
단 +c«Tiposke 


-Table 


Lahd 


I— Shdi 


그림 12-10. 추가하려는 부분품 


一 놓임새의 설정 

GUI 응용프로그람을 작성할 때 에는 단추의 배 치 등 사용의 편리성 을 고려하여 화면 
을 설계 하는것 이 중요하다. Shell 이 나 Composite 에 부분품을 몇 렬로 어떻게 배 치 하겠 
는지를 보고 위치나 크기를 지정하는데는 놓임새들라스를 사용한다. 표 12-1 에는 표준 
놓임새에 대하여 보여주었다. 이것들은 추상클라스 Layout 의 하위클라스들이다. 
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표 12-1. 표준놓임새클라스 


FillLayout 


RowLayout 


GridLayout 


FormLayout 


동일 한 크기 의 부분품들을 하나의 행 혹은 렬 에 배 치한다. 가장 간 
단한 놓임새이며 부분품들사이 공간이 나 여백을 지정할수는 없고 간 
격없이 통채 로 사용한다. 여 러개의 부분품들이 포함되 여있는 경우에 
는 모든 부분품들이 제일 큰 부분품과 같은 크기로 된다. 

FillLayout 와 같이 부분품들을 행 혹은 렬 에 배 치 하지 만 마당의 설 
정을 통하여 한 행 에 들어가지 못할 때 에는 다음 행 에 보내기 
(wrap=true) 도 하고 부분품의 크기에 맞추어 자연스러운 크기로 
배 치 (pack=true) 하기도 하며 복합체가 커지면 빈 공간을 부분품들 
사이에 균등하게 분할하여 넓히기 (justy=true) 도 하는 등의 지정 이 
가능하다. RowData 객체에 의해 각 부분품들의 높이와 폭을 지정 
할수 있다. 

부분품을 격 자우에 배 치한다. 복잡한 설정 시 가장 일 반적 으로 사용 
하는 놓임새이다. 몇렬로 부분품을 설치하겠는가를 지정할수 있으며 
HTML 의 Table 과 같이 GridData 와 조합하여 가로세로 배치를 정 
의할수 있 다. 

FormAttachmenl^ 리용하여 부모합성 이 나 다른 부분품을 지정 한 
부분에 접 속하는것 으로 놓임 새 를 결정한다. FormData 객 체 를 사용하 
여 각 부분품을 어 떻게 배 치하겠는가를 지정한다. 


여기서는 GridLayout 를 사용한다. 그림 12-10 을 본다. 

창문의 기본부분을 크게 보면 우에서부터 차례로 

1. 달력조종하는 Composite 

2. 달력 을 표시하는 Table 

3. 당일의 날자를 표시하는 Label 

이 세부분이 한개 렬에 놓인다. 《 달력조종 Composite》 는 왼쪽에 현재 대 면부에 펼 
쳐진 달력의 년，월을 가리키는 Text 부분이 있고 오른쪽에 달력을 전달 혹은 다음달로 
전환시킬수 있는 단추들이 놓이는《단추 Composite》 가 배치되였기때문에 2렬의 부분품 
이 놓인것 으로 된다.《 단추 Composite》 에는 또 3개의 단추가 병 렬로 놓였으므로 3렬의 
부분품이 놓인것으로 볼수 있다. 

먼저 Composite 와 Text, Button 부분품을 사용하여 《 달력조종 Composite》 의 부 
분만 창문에 추가한다. 원천코드는 목록 12-2 와 같다. 
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목록 12-2. Text 와 Button 의 배치 _ 

package sample , swt ； 
import org . eclipse , swt . SWT : 
import org . eclipse , swt . layout . GridData ； 
import org . eclipse , swt . layout . GridLayout ; 
import org . eclipse , swt . widgets . Button ; 
import org . eclipse . swt . widgets . Composite ； 
import org . eclipse , swt . widgets . Display ； 
import org . eclipse . swt . widgets . Shell ； 
import org . eclipse . swt . widgets . Text ； 

public class CalendarMain { 
private Shell shell ； 
private Text displayText ； 

»> CalendarTable 성 원변수 추가부분 ( A ) 
private Shell getCalendarShell (Display display ) { 
shell=new Shell ( display ) : 


shell . setText("Calendar Sample Application ”); 
shell . setSize (350, 250); 

shell . setLayout(new GridLayout (1, true )) : (1) 

//달력 조종 Composite 의 작성 
Composite ctlComp=new 

Composite ( shell , SWT . NO _ FOCUS ) ； (2) 
ctlComp . setLayout (new GridLayout (2, true )) ； (3) 

GridData compData=new GridData 0; 

compData . horizontalAlignment = GridData . FILL ； (4) 

ctlComp . setLayoutData ( compData ); 

//Text box 의 작성 

displayText=new Text ( ctlComp , SWT . SINGLE | SWT . BORDER ); (5) 
GridData textData=new 

GridData ( GridData . FILL - HORIZONTAL ); (6) 
displayText . setLayoutData ( textData ) ； 


// 단추 Composite 의 작성 

Composite buttonComp=new Composite ( ctlComp , SWT . NO _ FOCUS ) : 
buttonComp . setLayout (new GridLayout (3, true )); 

GridData bu 竹 onData=new GridData ( GridData . FILL ) : (7) 
buttonData . horizontalAlignment = GridData . END ； (8) 
buttonComp . setLayoutData ( buttonData ); 

//단추의 작성 
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Button button _ prev=new Button ( buttonComp , SWT . PUSH ); (9) 
button _ prev . setText ("<<"); 

>〉〉감시 자 주가부분 ( B ) 

Button button _ this _ month=new Button ( buttonComp , SWT . PUSH ) ； 
Button _ this _ month . setT ext 

〉>〉감시 자 주가부분 ( B ) 

Button button _ next=new Button ( buttonComp , SWT . PUSH ) ； 
button _ next . setText (”〉 〉’’) ； 

〉〉〉감시 자 추가부분 ( B ) 

»> 표부분품 추가부분 ( C ) 

»> 표식부분품 추가부분 ( D ) 

»> 차림표부분품 추가부분 ( E ) 
return shell ； 

} 

public static void main (String [] args ) { 

Display display = new Display 0 : 

Shell shell =new CalendarMain (). getCalendarShell ( display ) ； 


// 쉘을 연다. 

Shell . open () ； 

while(!shel 1. isDisposed 0) { 

if (! display . readAndDispatch ()) 
Display , sleep 0 ； 

} 

display , dispose 0 ； 


실 행하면 그림 12-11 과 같은 화면 이 현시 된 다. 


Calendar Sample Application 


나이와 


신신 신 



그림 12-11. 달력조종 Composite 의 추가 
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이 화면과 목록 12_2를 동해 사용된 부분줌에 대하여 자세히 보기로 한다. 

월에는 1렬로 부분품이 놓이기때문에 GridLayout 의 구성자의 첫 인수는 1로 한다 
(1). 두번째 인수는 true 로 지정한다. 이것은 렬의 폭을 자동적으로 등간격으로 하겠는지 
를 지정하는것인데 한개 렬인 경우는 false 로 설정했을 때 렬의 폭이 고정된다. Shell 에 
Layout 을 설정하고 이어서 달력조종 Composite 를 작성한다 (2). 이 Composite 의 부모는 
쉘이므로 인수에 shell 을 설정한다. 달력조종 Composite 에는 Text 와 단추 Composite 인 
두 부분품이 2렬로 놓이기 때문에 GridLayout 의 구성자의 첫 인수는 2로 한다 (3). 두 
부분품의 폭을 같게 하기 위해 두번째 인수는 true 로 한다. 달력조종 Composite 는 월이 
커지면 거기에 맞추어 수평방향으로 늘어나게 설정한다 (4). 

GridData 객체는 재리용할수 없다는데 주의해야 한다. GridLayout 로 관리하고있는 
부분품은 모두 유일한 GridData 를 가져야 한다. SetLayoutData 에서 명시적으로 지정 
하지 않는 경우에는 기정의 GridData 가 생성된다. 

一 본문칸 

본문칸을 작성 한다 (5). 부모 Composite 는 이 미 작성 한 달력 조종 Composite 이 므로 
구성 자의 첫인수는 ctlComp 이 다. 두번째 인수는 격 식 조종인데 SWT . SINGLE 로 1행 만 
표시하고 SWT . BORDER 로 테두리를 준다. Text 의 구체 례인 display Text 는 현시 된 
달력의 《년，월》표시를 내부클라스로부터 변경하기 위하여 성원변수로 정의하고있다. 

창문크기 가 변하면 그에 대 응하여 본문칸이 수평 방향으로 늘어 나도록 설정 한다 (6). 
한편 단추 Composite 는 크기를 고정하려고 구성자의 인수에 GridData . FILL 을 설정하였 
다 (7). 단추 Composite 를 오른쪽끝에 배치하기 위 해 horizintalAlignment (수평 배치)마 
당에 GridData . END 를 설정한다 (8). 

一 단추 

단추부분품의 작성에는 org . eclipse , swt . widgets . Button 을 사용한다. 이 클라스 
하나에 목록 12-3 과 그림 12-12 와 같은 절 환단추，검 사단추，라지 오단추를 설 정한다. 


목록 12-3. 단추부분품의 작성 

Button buttonl = new Button ( shell , SWT . TOGGLE ) : 
buttonl . setText ("절환단추’’) ; 

Button button 2 = new Button ( shell , SWT . CHECK ) : 
button 2. setText ("검 사단추’’) ； 

Button button 3 = new Button ( shell , SWT . RADIO ) ； 
button 3. setText (’’ 단일 선택 단추”) ; 
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ᅵ이 x 



그림 12-12. 단추의 목록 

목록 12-2 에서는 보통단추를 사용하는데 격식조종으로 SWT.PUSH 를 지정하였다 (9). 

一 표 

달력 부분에 서 표를 작성 하는데 org . eclipse , swt . widgets . Table 을 리 용한다. 달력 
의 표시와 변경 등의 처리를 다른 클라스에서 한다. 목록 12-4 에 CalendarTable 클라 
스를 새 로 작성하였 다. 


목록 12-4. CalendarTable 클라스 

import java . util . Calendar ； 
import java . util . GregorianCalendar ； 

import org . eclipse , swt . SWT : 
import org . eclipse , swt . layout . GridData ； 
import org . eclipse . swt . widgets . Composite ； 
import org . eclipse . swt . widgets . Table ； 
import org . eclipse , swt . widgets . TableColumn ; 
import org . eclipse , swt . widgets . Tableltem ； 

public class CalendarTable { 

Table table ； 

//요일의 정의 

static final String [] WEEK = 

{，， Sun ”，" Mon M , M Tue M , M Wed M , M Thu M , M Fri M , M Sat M }； 

// 현재 표에 표시하고있는 달력 
private Calendar display Calendar : 

// 오늘의 년，월，일，요일 
int iThisYear ； 
int iThisMonth ； 
int iThisDate ； 
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int iThisWeek ； 


* Sparam parent Table 구체례의 부모로 되는 부품 

* Sparam style 격식조종 
*/ 

public CalendarTable(Composite parent, int style) { 
// 현재시각 ( 기정지역，시간대)으로 
// GregorianCalendar 를 구축 

this, display Calendar = new GregorianCalendar () : 


iThisYear = displayCalendar. get (Calendar. YEAR) ； 
iThisMonth = displayCalendar. get (Calendar. MONTH) : 
iThisDate = displayCalendar. get (Calendar. DATE) ； 
iThisWeek = displayCalendar. get (Calendar. DAY_OF_WEEK) ； 

table = new Table(parent, style); 
setup 0; 


private void setup 0 { 

// Set Grid Data 

GridData tableGridData = new GridData(GridData. FILL) ； 
tableGridData. horizontal Alignment = GridData. CENTER; (1) 
tableGridData. verticalAlignment = GridData. CENTER; 
table. setLayoutData(tableGridData); 

// 격자선의 현시 

table. setLinesVisible(true); .(2) 

// 렬의 머리부표시 

table. setHeaderVisible(true) ； 

// 렬의 머리부에 요일설정 

for (int iCol = 0 ； ICol < WEEK, length ； iCol++) { (3) 

TableColumn col = new TableColumn(table, SWT. CENTER) ； 
col. setText (WEEK [iCol]) ； 
col. setWidth(40); 


private String setCalendarO { 

String strYYMM = MM ； 

//달력의 내용을 일단 지운다 
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table. removeAllO ； 

// 현시하려 는 년，월의 문자렬을 작성 

strYYMM =(”，，+ display Calendar, get (Calendar. YEAR) + ”년，， + 
(displayCalendar. get (Calendar. MARCH) + 1) + ’’월”); 


Calendar tmpCal = (Calendar) displayCalendar. clone 0 ； 

// 날자를 해 당한 달의 1일부터 순서 대 로 표에 설정한다 
tmpCal. set (Calendar. DAY_OF_MONTH, 1); 
int iDispMonth = displayCalendar. get (Calendar. MONTH) : 

Tableltem item = new Tableltem(table, SWT.NULL); 


// 1 달분표시 

while (iDispMonth == tmpCal. get (Calendar. MONTH)) { 


// 주가 변하면 Tableltem 을 추가하여 다음행으로 한다 
if (tmpCal. get (Calendar. DAY_OF_WEEK) == 

Calendar. SUNDAY) { 

item = new Tableltem (table, SWT. NULL) : 

} 

item. setText (tmpCal. get (Calendar. DAY_OF_WEEK) - 1, 
Integer. toString (tmpCal. get (Calendar. DATE))); 

// 하루 전진 

tmpCal. add (Calendar. DAY_OF_MONTH, 1) ； 

} 

return strYYMM； 


public String getTodaysYYMMDDO { 

String strYear = Integer. toString (iThisYear); 

String strMonth = Integer. toString (iThisMonth + 1); 
String strDate = Integer. toString (iThisDate); 

String strDayOfWeek = WEEK[iThisWeek - 1]; 

String strYYMMDD = strYear + ” + strMonth + 7” + 

strDate + ’’ [’’ + strDayOfWeek + ; 

return strYYMMDD； 


I 於於 
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* 달력 을 다음달로 변경한다 . (4) 

* 

* 9 return 달력 에 표시 하는 년월의 문자렬 
*/ 

public String setNextMonthO { 

displayCalendar. add (Calendar. MONTH, 1) ； 
return setCalendarO ； 


I 於於 

* 달력 을 전달로 변경한다 . (4) 

* 

* Sreturn 달력 에 표시 하는 년，월의 문자렬 
*/ 

public String setPrevMonthO { 

displayCalendar. add (Calendar. MONTH, -1) ； 
return setCalendarO ； 


* 달력을 이번달로 변경 (4) 

* 

* 9 return 달력 에 표시 하는 년，월의 문자렬 
*/ 

public String setThisMonthO { 

displayCalendar. set(iThisYear ， iThisMonth, iThisDate) ； 
return setCalendarO : 


목록 12-2 의 (A) 와 (C) 자리에 아래의 원천코드와 같은 성원변수의 정의와 
CalendarTable 의 구체 례 를 생 성하는 부분을 추가한다 (두꺼 운 글자부분 ) . 
CalendarTable 의 구성자의 인수는 일반적 인 SWT 부분품과 같이 부모 Composite 와 격 
식조종으로 되여있다 . 


public class CalendarMain { 
private Shell shell ； 
private Text display Text ； 
private CalendarTable table ； 
private Shell getCalendarShell (Display display) { 
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〜르주 〜 

Button button_next=new Button(buttonComp, SWT. PUSH) : 
button_next. setText(">>"); 

// CalendarTable 의 작성 

table=new CalendarTable(shell, SWT. EMBEDDED | SWT. BORDER); 
displayText. setText(table. setThisMonthO); 
return shell ； 


CalendarTable 클라스에서는 구성자의 인수를 사용하여 Table 구체례를 생성한다 . 
Setup 메 쏘드안에 GridData. setLayoutData 를 써 서 현시 위치를 가운데 로 설정 하고있 
다 . (목록 12-4(1)) Table 에 격자선을 표시하고 (2) 렬의 머리부에 요일들을 설정하였다 . 

이 달의 달력 을 표시하는 메 쏘드와 다음달，전달의 달력 으로 변화시 킬수 있는 메 쏘드 
를 각각 만든다 (4). 귀환값의 문자렬들은 달력 이 현재 표시하고있는 년，월의 문자렬인 
데 그것 을 Text 에 표시한다 . 

달력의 월，일표시나 다음달，전달의 변환 등에는 java.util.Calendar 클라스를 리 
용한다 . 

一 표식 

표식 을 작성한다 . Label 구체 례 를 생 성 하고 CalendarTable 클라스의 

getTodaysYYMMDD 메 쏘드로부터 얻은 해당한 날의 날자를 setText 메 쏘드를 리 용하 
여 표식 에 설정하도록 한다 . 목록 12-2 의 (D ) 위 치밑 에 다음의 코드를 추가하며 
org. eclipse, swt. widgets. Label 클라스를 반입 한다 . Import 문을 추가할 때 지 름건 
Ctrl+Shift+M 을 쓰면 편리하다 . 표식작성하는 부분을 선택하고 이 지름건을 누르면 [Add 
Import ] 대화칸이 나오는데 여기서 org.eclipse.swt.widgets.Label 을 선택한다 . 

//Label 의 작성 

Label label=new Label (shell, SWT. NONE) : 

//당일의 년월일을 표시 

label. setText ("Today : M +table. getTodaysYYMMDD ()); 

표식은 setFont(Font) 로 서체를 설정할수 있고 문자만이 아니라 set Image (Image) 에 
의 해 화상도 삽입할수 있다 . Text 와 같이 격 식 조종을 사용하여 테 두리의 설정 등도 가 
능하다 . 
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一 감시 자 

단추에 사건을 추가하여 CalendarTable 클라스의 표시 달을 변화시 키 는 메 쏘드를 
호출한다 . 목록 12-2(B) 위치에 아래의 코드에서 굵은 글자로 쓴 부분을 써넣어 단추 
부분품의 구체 례 에 Listener (감시 자 ) 를 추가한다 . 

org. eclipse, swt. widgets. Listener 클라스와 org. eclipse, swt. widgets. Event 클 
라스를 반입한다 . button_prev 단추가 눌리는 사건처 리 에서 setPrevMonthO 를 호출 
하고 귀 환값을 displayText 에 설정한다 . bu 竹 on_this_month 의 경 우는 CalendarTab 
le 의 setThisMonthO 를， bu 竹 on_next 인 경우 CalendarTable 의 setNextMonth 를 
호 줄 한다 . 

Button button_prev=new Button(buttonComp ， SWT. PUSH) ; 
button_prev. setText ("<<"); 

button_prev. addListener(SWT. Selection, new Listener() { 
public void handleEvent (Event e) { 
displayText. setText (table. setPrevMonthO); 

} 

})； 

Button button_this_month= 

new Button(buttonComp, SWT. PUSH); 
button_this_month. setText(’’■”); 

button_this_month. addListener (SWT. Selection, new Listener () 

{ 

public void handleEvent (Event e) { 
displayText. setText (table. setThisMonthO); 

} 

})； 

Button button_next= 

new Button (buttonComp, SWT. PUSH) ； 
button_next. setText( M >>") ； 

button_next. addListener (SWT. Selection, new Listener () { 
public void handleEvent (Event e) { 
displayText. setText (table. setNextMonth ()) ； 

} 

}); 

一 차림표 

먼저 Listener 구체 례 를 생 성 하고 차림 표에 추가하려 는 사건들을 정 의한다 . 목록 
12-5 를 목록 12-2(E) 자리에 추가한다 . 다음과 같은 import 문이 필요하다 . 

import org. eclipse, swt. widgets. Menu ； 
import org. eclipse, swt. widgets. Menultem ； 
import org. eclipse, swt. widgets. MessageBox ； 
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목록 12-5. 차림표의 작성 


Listener exitListener = new Listener () { 
public void handleEvent (Event e) { 

MessageBox dialog = new MessageBox(shell ， SWT.OK | 
SWT. CANCEL | SWT. ICON_QUESTION); (1) 
dialog. setText(’’Question”); 
dialog. setMessage("Exit?") ； 
if (e.type == SWT. Close) 
e.doit = false ； 

if (dialog, open() 卜 SWT. OK) 
return ； 

shell, dispose0; 

} 

}； 

Listener aboutListener = new Listener () { 
public void handleE vent (Event e) { 

MessageBox dialog = new MessageBox (shell, SWT. OK| 
SWT. ICON-INFORMATION); (2) 
dialog. setText("About); 

dialog. setMessage ("Eclipse Calendar Sample Application.”); 
if (dialog, open() == SWT. OK) 
return ； 

shell, dispose0; 


//차림표 

Menu mb = new Menu (shell, SWT. BAR) ； (3) 
shell. setMenuBar(mb); (4) 

Menultem fileltem = new Menultem(mb, SWT. CASCADE); (5) 
Menultem helpltem = new Menultem (mb, SWT. CASCADE) : 

Fileltem. setText ( M &File M ) ； 

Menu fileMenu = new Menu(shell, SWT.DROP_DOWN); (6) 
fileltem. setMenu(fileMenu) ； (7) 

Menultem exitltem = new Menultem (fileMenu, SWT. PUSH); (8) 
exitltem. setText("&Exit\tCtrl+X") ； 

exitltem. addListener(SWT. Selection, exitListener) ； (9) 
exitltem. set Accelerator (SWT. CONTROL + ’X’); (10) 

helpltem. setText( ? '&Help"); 

Menu helpMenu = new Menu(shell, SWT.DROP_DOWN) ； 
helpltem. setMenu(helpMenu); 

Menultem aboutltem = new Menultem (helpMenu, SWT. PUSH); 
aboutltem. setT ext ( M &About\tCtrl+A M ); 
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aboutltem. set Accelerator (SWT. CONTROL + ’A’); 
aboutltem. addListener(SWT. Selection ， aboutListener) ； 


사건감시자의 처리를 진행할 때 코드를 읽거나 객체의 재리용성을 높이는 측면에서 이 
름이 없는 클라스는 피하는것이 좋다 . exitListener 는 통보칸을 현시하여 응용프로그람을 
끝내 기 하겠는가를 사용자에 게 물어 본다 . MessageBox 구체 례 의 생 성 시 에 동보칸을 질 문형 식 
으로 만드는데 OK ( 확인)， Cancel ( 취소)를 표시하는 등 속성을 지정한다 (1). 
AboutListener 도 마찬가지로 MessageBox 구체 례를 생성 하지만 구성자의 인수에서 격식 조종 
에는 SWT.OK|SWT.ICON_INFORMATION 을 설정하여 정보대화칸을 표시한다 (2). 

감시 자를 생 성 하고 계 속하여 차림 표부분품을 만든다 . 차림 표띠 를 생 성 (3) 하고 
shell 에 설정한다 (4). 생성한 차림 표띠 에 차림 표항목을 작성한다 (5). 다음은 누르면 아 
래로 펼처지는 차림표를 작성하여 (6) 이것을 차림표항목에 설정한다 (7). 그리고 최종적 
으로 선택 하기 위한 차림표항목을 작성한다 . 이것은 (6 ) 에서 작성한 부분차림 표를 포함 
한다 (8). 이 차림표에 Listener 를 추가한다 (9). 매개 차림표항목에는 (10 ) 과 같이 간 
단히 지름건을 추가할수 있다 . 이상으로 그림 12-1 에서 보여준 견본응용프로그람을 작 
성하였다 . 


제3절. Swing 부품과의 통합 

Swing 의 부품을 결 합하여 SWT 응용프로그람을 작성할수 있 다 . 

앞에 서 만든 달력 프로그람에 Swing 부품을 추가해본다 . Jtree 를 리 용하여 년，월 을 
계 층구조로 표시한다 . 감시 자를 붙여서 두번 찰칵하면 지정한 년，월의 달력 으로 변하게 
한다 . 

먼저 CalendarTable 클라스에 년，월을 직접 지정하여 달력의 현시를 변화시키는 
메쏘드 setSpecifiedMonth 를 추가 한다. 

목록 12-6. CalendarTable 에 년, 월을 지정하는 메쏘드를 추가 

I%% 

* Sparam iYear 현시하려 는 년 

* Sparam iMonth 현시하려 는 달 

* 9 return 달력 에 표시 하는 년，월 의 문자렬 
*/ 

public String setSpecifiedMonth (int iYear, int iMonth) { 
displayCalendar. set (iYear, iMonth, iThisDate) ； 
return setCalendarO ； 
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CalendarMain 클라스는 javax. swing. JTree 부품을 작성 하여 마우스감시 자를 추가 
한다 . TreeNode 를 두번 찰칵하여 선택한 년，월을 얻 어 setSpecifiedMonth 를 호출한 
다 . 다음의 감시자(목록 12-7) 를 getCalendarShell 메쏘드의 제일 마지막에 있는 
《 return shell ;》문앞에 추가한다 . 필요되는 import 문도 지름건 Ctrl+Shift+M 을 리용 
하여 추가한다 . 

import java. awt. event. MouseAdapter ； 
import java. awt. event. MouseEvent ； 
import java. awt. event. MouseListener ； 
import javax. swing. JScrollPane ； 
import javax. swing. Jtree ； 

import javax. swing, tree. DefaultMutableTreeNode; 
import javax. swing, tree. TreePath ； 
import org. eclipse, swt. awt. SWT_AWT ； 

getCalendarShell 의 제일 앞에 shell 의 크기를 setSize 메쏘드에 의해 지정하고 있 
지만 Jtree 를 넣을만한 크기만 필요하므로 《 shell.setSize(350,400) ;》으로 변경한다 . 

목록 12-7. Swing 부품의 추가 

// Swing 부품의 부모인 Composite 

Composite swingComp = new Composite (shell, SWT. EMBEDDED) ； 

swingComp.setLayout(new GridLayout(l, true)); 

GridData swingCompData = new GridData(GridData. FILL_BOTH); 

swingComp. setLayoutData(swingCompData); 


// 새로운 AWT Frame 을 작성 

java. awt. Frame awtFrame = SWT_AWT. new_Frame(swingComp) ； 


java. awt. Panel panel = new java. awt. Panel (new java. awt. BorderLayoutO) ； 
awtFrame. add (panel); 


DefaultMutableT reeNode root = 

new DefaultMutableT reeNode ("Select Month”); 

DefaultMutableT reeNode nodePreYear = 
new DefaultMutableTreeNode( M 2003 M ); 

DefaultMutableT reeNode nodeThisYear = 
new DefaultMutableTreeNode( M 2004 M ); 

DefaultMutableT reeNode nodeNextYear = 
new DefaultMutableTreeNode("2005 ? ') ； 


root, add (nodePreYear) ； 
root, add (nodeThisYear); 
root, add (nodeNextYear) ； 
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for (int iMonth = 1 ； iMonth < 13 ； iMonth++) { 
nodePreYear. add (new 

DefaultMutableTreeNode(Integer. toString(iMonth))); 
nodeThisYear. add (new 

DefaultMutableT reeNode (Integer. toString (iMonth))) ； 
nodeNextYear. add (new 

DefaultMutableT reeNode (Integer. toString (iMonth))); 


final JTree swingJtree = new JTree(root) ； 
swingJtree. setDoubleBuffered(true) ； 

// 마우스감시 자 

MouseListener ml = new MouseAdapterO { 
public void mousePressed(MouseEvent e) { 

TreePath selPath = swingJtree.getPathForLocation(e.getX(),e.getY0 )； 


if (e. getClickCount0 == 2 && selPath != null && 
selPath. getPathCountO == 3) { 
Object [] selMonth = new Object[3] ； 
selMonth = selPath. getPathO : 


final int iYear = 

Integer. valueOf (selMonth [1]. toString0). intValue0 ; 
final int iMonth = 

Integer. valueOf (selMonth [2]. toString ()). intValue 0 - 1 ； 

shell.getDisplayO.syncExec(new Runnable(){ (1) 

public void runO { 

// 달력을 지정한 년월로 변경한다 . 
displayText. setText 

(table. setSpecifiedMonth (iYear, iMonth)) ； 

} 

})； 


}； 

swingJtree. addMouseListener(ml); 

JScrollPane scrollPane = new JScrollPane(swingJtree) ； 
panel. add(scrollPane); 


Swing Listener 로부터 SWT 의 GUI 를 변경한다 . 이 때 다음과 같은것 에 주의 해 야 
한다 . SWT 응용프로그람은 월을 닫을 때까지 사건순환을 실행한다(목록 12-1(4)). 이 
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동안에 마우스조작 등이 진행된 경우 조작체계 로부터 GUI 사건을 대기렬로 받고 처 리를 
진행한다. 이것을 응용프로그람의 〈〈UI 스레드》라고 부론다. 모든 사건은 응용프로그람 
의 UI 스레드가 방아쇠 (trigger) 로 되여 있으므로 사건을 처 리 하는 응용프로그람코드는 
부분품에로의 자유로운 접근이 허가되여 특별한 조작없이 GUI 의 변경 등이 가능하다. 
여 기서 원래 상정 되 여있지 않은 Swing 등의 비 UI 스레 드로부터 SWT 의 UI 스레드가 직 
접 호출되 면 SWT 례 외 가 발생한다. 

이 것 을 피 하기 위 하여 display. syncExec 메 쏘드에 Runnable 의 구체 례 를 넘 긴 다. 
Runnable 의 run 메 쏘드를 경 유하여 SWT 의 부분품을 변경한다(목록 12-7(1)). 
SyncExec 는 호출하는 쪽의 스레 드를 차단하여 적절한 시기 에 UI 스레 드안에서 지정한 
처리를 실행 한다. 

Swing 부품을 SWT 응용프로그람에서 사용하는 경우 실례 로 새 로 작성한 SWT 응용 
프로그람에 기존의 Swing 응용프로그람의 일부를 재리용한다는 점에서 생각해본다. 이 
절에서 소개한것처럼 Swing 과 SWT 는 통합할수 있지만 사건의 처리가 힘들고 복잡하 
다. 가볍 고 고속성 을 보장할수 있다는 리유로 응용프로그람을 SWT 로 작성하는것 이지 만 
응답향상의 측면으로부터 기 존의 Swing 부품을 순차적 으로 SWT 에 로 이 행하는 편 이 낫 
다. SWT 와 Swing 이 완전히 1 대 1 로 대응되지 않으므로 Swing 과 같이 가동기반을 쓰 
지 않고 완전히 동일한 모양과 기능을 제공한다는것은 SWT 에서 불가능하다. 대표적으 


로 부품에 대하여 

Swing 과 SWT 의 대 응관계는 표 12-2 와 같다. 

표 12-2. 

Swing 과 SWT 2 I 대응 


Swing 

SWT 

창문모양 

JF rame 

Shell 


JPanel 

Composite 


JMenu, JMenuBar 

Menu 


JToolBar 

ToolBar, CoolBar 


JScrollBar 

ScrollBar 

입력 

JButton 

Button+SWT.PUSH 


JToggleButton 

Button+SWT. TOGGLE 


JCheckBox 

Button+SWT. CHECK 


JRadioButton 

Button+SWT. RADIO 


JComboBox 

Combo 


JFileChooser 

FileDialog 


JFileChooser 

Directory Dialog 


JTextField 

Text+SWT. SINGLE 


JTextArea 

Text+SWT. MULTI 


JSlider 

Slider 

표시 

JLabel 

Label 


JList 

List 


JTree 

Tree 


JTable 

Table 
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제13장. 끼워넣기개발의 초보 

이 장에서는 끼워넣기개발의 초보에 대하여 소개한다 . 

제1절. 끼워넣기의 구조 

Eclipse 본체 에는 확장점 (extension point) 이 라고 하는 대면이 있다 . 이 대면을 실 
현한 클라스를 확장들라스라고 한다 . 그리고 어느 클라스가 확장되였는가를 Eclipse 의 
끼워 넣기기구에 전달하는 파일 이 끼워 넣기명시 (plugin.xml) 이 다 . Eclipse 에서 끼워 넣 
기 라는것은 확장점 에서 정의된 대면의 실현클라스와 끼워넣 기명시를 조합한것 이 라고 말 
할수 있다 . 엄밀한 정의를 한다면 좀 어 렵고 초기 에는 이 정도의 리해로 시 작한다 . 간단 
한 끼워넣기를 만들어보면서 끼워넣기의 구조를 본다 . 


제2절. Hello 끼워널기 

Eclipse 끼 워넣 기는 Eclipse 를 사용하여 개 발한다 . 

Eclipse 의 전신인 IBM Visual Age for Java 본체는 Smalltalk 로 개발되였다 . 그래 
서 Eclipse 를 개 발하고있는 IBM 에 있어서 Java 로 IDE 를 만든다는것 이 혁 신적 인것 이 였 
다 . 끼 워 넣기를 개 발할 때 [Plug in Development Perspective] (그림 13_1) 을 사용하 
면 편리 하다 . 이 투시는 Java 투시와 비슷하고 사용방법도 크게 다른것 이 없다 . 

이제부터 만드는 끼워넣기는 [Hello 끼워넣 기]라고 부르는데 Eclipse 가 제공하는 간 
단한 견본이다 . 

1. 작업 대 의 도구띠 에 서 [New] 단추를 선택 하고 [Plug-in Development] ^ 
[Plug-in Project] 를 선택한 다음 [Next] 를 찰칵하여 [New Plug-in Project] 대 화칸 
을 연다 . 

2. 그림 13_2 와 같이 프로젝 트이 름에 [kp. ac. kut. example, hello] 라고 입 력 한다 . 
다른 사람이 작성한 끼워넣기와 혼돈하지 않기 위해 프로젝트의 이름달기는 이처럼 령역 
이름형식으로 하였다 . 그리 고 다음에 나오는 끼워넣기 ID 도 프로젝트이름과 같은것을 사 
용한다 . [Next] 를 찰칵한다 . 
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그림 13-1. 끼워넣기개발투시 



Plug-in Project 

Create a new plug-in project 




Project name: kp.ac.kut.example.helloj 



< Back Next > Cancel 



그림 13-2. 새 끼워넣기프로젝트 
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3. [Plug-in Properties] 안의 끼 워 넣 기 이 름，끼 워 넣 기 판번호，끼 워 넣 기제 공자，클 
라스이름을 입력한다 . 여기서는 끼워넣기제공자에 《 KUT 》 를 입력하고 판번호를 0.0.1 
로 한다 . 이 외 에는 자동적 으로 입 력되 여있는 값을 그대 로 사용한다 . 즉 끼워넣기 ID 는 
프로젝 트이 름과 같다 . 그리 고 [Plug-in Class] 안의 두개 의 검 사칸 [Generate the java 
class that controls the pulg - in，s life cycle] 과 [The pulg-in will contributions 
to the UI] 를 선택한다 . 마지막에 [Next] 를 찰칵한다 . (그림 13_3) 



그림 13-3. 끼워 넣기 프로젝트구조 

4. 코드생성조수를 리 용하여 코드를 생성한다 . 여 기서 는 [Create a pulg-in using 
one of the templates] 을 선택 하여 [Hello World] 를 선택 한 다음 [Next] 를 찰칵한다 
(그림 13-4). 
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그림 13-4. 끼워넣기쿄드생성 

5. [Sample Action Set ] 대화칸은 Hello World 고유의 정보를 
World 는 차림 표띠 나 도구띠 에 단추를 추가하는 끼워넣 기의 형판이다 . 
라스이 름도 입 력 하고 단추를 눌렀을 때 현시할 통보문도 입 력한다(그림 


입 력한다 . Hello 
그래서 Action 클 
13-5). 


plug-in project 


Sample Action Set 

This template will generate a &ampJe action set extension with a memj 卜 a 
menu item and a tool bar button. 


■ j 卜 寶 


Java Package Name: kp.ac.kut.example.hello.actions 


Action Class Name: SampleActiorf 


Message Sox Text: Hello, Eclipse world 


< Back 


Brash 

Cancel 



그림 13-5. Sample Action Set 대화칸 
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6. [Finish] 를 찰칵한다 . 

새 끼 워 넣 기 가 작성 되 면 작업 대 에 [Overview] 라는 페 지 가 나타난다 (그림 13_6) . 
이렇게 Hello 끼워넣기가 완성된다 . 이제는 끼워넣기를 기동시켜 본다 . 


k p. ac. kur.ex am pie. hell o : 


Overview 


General Information 




日 


This section describes general information about this 
plug-in 


ID: 

Version: 

Name: 

Provider: 

Class: 


kp.ac.kiitexample.hello) 


0 요 1 


Hello Plug-in 


KUT 


kp.ac.kut.example.hello.HelloPlug Browse 


Testing 

You can test the plug-in by launching a second 
(runtime) instance of the workbench: 

o Launch a runtime workbench 
늘 Launch a runtime workbench in Debug mode 


© 


② 


Plug-in Content 

The content of the plug-in is made up of four sections: 

Dependencies: lists all the plug-ins required on this 
plug-in's classpath to compile and run. 

’ Runtime: lists the libraries that make up this plug-in's 
mntiniG. 

: ,r Extensions: declares contributions this plug-in makss 
to the platform. 

! ■’ Extension Points: declares new function points this 
plug-in adds to the platform. 

Deploying ® 

To deploy the plug-in: 

1. Specify what needs to be packaged in ths deployable 
plug-in on the Build Configuration page 

2 . Export the plug-in in a format suitable for deployment 
using the Export Wizard 


Overview Dependencies Runtime Extensions Extension Points Build plugin.xml build.properties 


그림 13-6. Overview 페지 


그러자면 

1. [Package Explorer] 보기 에 서 [kp.ac.kut. example, hello] 를 선택 한다 . 

2. 차림 표띠 에서 [Run] —[Run] 을 선택 하면 실행대 화칸이 기동한다 . [Run-time 
Workbench] 를 선택하고 [Name] 에는 《 Hello 》 를 입력한다 . 그다음 왼쪽아래에 있는 
[New] 를 찰칵한다(그림 13-7). 마지 막에 [Run] 단추를 눌러 실 행한다 . 

3. 그러면 새로운 작업대가 기동한다 . 오른쪽우의 최소화단추를 눌러 [Welcome] 
창을 작게 한다 . 

그리고 Hello 끼워넣기가 어디에 매몰되는지 살펴본다 . 먼저 볼것은 도구띠에 있는 
[Hello Eclipse World] 단추이 다 . 그 다음은 차림 표에 있는 [Sample Menu] 이 다(그림 
13-8). 어느것으로 실행해보든 결과는 둘다 그림 13-9 와 같다 . 
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그림 13-7. 기동대화칸 




그림 13-8. 매몰된 Hello World 끼워넣기 
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그림 13-9. Hello 끼워널기의 실행결과 


Hello 끼 워넣 기의 기능은 

① 간단한 대 화칸동보문을 현시하는것 

② 차림표띠에 차림표를 추가하는것 

③ 도구띠 에 단추를 추가하는것 이 다 . 

우의 ①〜③이 확인되면 끼워넣기를 실행한 Run-time 작업대를 끈다 . 

끼워넣 기를 작성할 때 에 다음과 같은것을 진행해 야 한다 . 

1. 끼워넣기를 Eclipse 본체와 어떻게 통합하겠는가를 결정한다 . 

2. 끼워넣기를 통합하기 위하여 추가할 필요가 있는 확장점을 확인한다 . 

3. 확장점의 양상에 맞게 확장을 실현한다 . 

4 . 제 공하는 확장과 코드의 패 키지를 서 술하는 끼 워 넣 기 명 시 (plugin, xml ) 를 제 공한다 . 
이 로부터 먼저 실제로 끼워넣기명시 나 실현클라스에 대 하여 보기로 한다 . 


제3절. 끼워널기명시 

Hello 끼 워넣 기를 만들 때 작업 대 에 《 Welcome 》 이 라고 쓴 편집 기 가 펼쳐져 있었다 . 
이것 이 끼워 넣 기명시 이 다 . [Package Explorer ] 보기 에서 plugin.xml 을 연다 . 그림 
13_6 에서 끼워 넣 기명시의 [Overview ] 페지를 보았다 . [General Information] 이 라고 
쓴 부분에 끼워넣 기 ID ， 끼워넣기이름，판번호，제공자명，클라스라는 정보가 있는것을 
알수 있다 . 동시에 [plugin.xml ] 폐지를 보면 파일의 앞머리에 같은 정보가 씌여져있는 
것을 알수 있다(목록 13-1). 이와 같이 끼워넣기명시에는 그것의 끼워넣기개발원천정보 
를 제 일 앞에 서술한다 . 

목록 13-1. 끼워넣기명시의 원천쿄드 앞머리부분 

〈plugin 

id= “kp.ac.kut. example, hello” 
name= “Hello 끼 워 넣 기 ” 
version^ “0.0.1” 
provide r_name= “KUT” 

class- “kp.ac.kut. example, hello. HelloPlugin” > 
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다음 [Dependancies ( 의존관계)]페지를 열고 보면 [Required Plug-ins] 에 《 . 
org. eclipse, ui 》 와 ( . org. eclipse, core, runtime } 이 씌 여 져 있 다 (그림 13-10). 여 기 서 
오른쪽의 [Add] 를 찰칵하여 [org.eclipse.core. resources] 끼 워넣 기를 추가하여 둔다 . 
이 끼워넣 기는 이 장의 뒤 에서 보게 되는 끼워넣 기전용화에서 필요하다 . [plugin.xml] 
페지 에서 보면 이 려 한 필수끼워넣기는 requires 요소안에 서술된다(목록 13_2). 
requires 요소에 쓸수 있는것은 이 끼워넣기가 반입하는 클라스를 포함하고있는 끼워넣 
기의 ID 이다 . 



그림 13-10. Dependencies 퍼 I 지 


목록 13-2. 끼워 넣기 명시 원천프로그람의 require 부분 

〈 requires 〉 

〈import plugin= “org. eclipse, ui” /> 

〈import plugin= “org. eclipse, core, runtime” /> 
〈import plugin= “org. eclipse, core, resources” /> 
〈 /requires 〉 


이 번에 는 [Run-time] 페지 를 열 어 본다(그림 13-11). [Run-time Libraries] 라고 
씌여진 곳에 hello, jar 가 들어있다 . Run-time Library 는 이 끼워넣기의 클라스적재기 
의 유효범 위 를 결정한다 . 지 금은 hello, jar 밖에 들어있지 않지 만 필요에 따라 더 늘일 
수도 있다 . 

[Library exporting] 은 서고를 다른 끼워넣기에서도 리용할수 있게 하겠는지를 지정한 
다 . 확장점을 제공하고있지 않을 때에는 반출할 필요가 없다 . 
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그림 13-11. Runtime 페지 

다음으로 [Extensions] 페지를 보면 [All Extensions] 에 {、. org. eclipse, ui. actionSets 》 
라고 되여있다 . 이것은 이 끼워넣기가 확장한 확장점이다 . 《 org.eclipse.ui.actionSets 》 를 
전개 해 나가면 [Sample Action] 이 라고 쓴것 이 있을것 이 다(그림 13-12). 이 경로를 선택 한다 . 
그러면 오른쪽의 령 역의 [class] 에 《 kp. ac. kut. example, hello, actions. SampleAction } 
라고 되여있다 . 확장점에 대하여는 [13.4 끼워넣기]에서 구체적으로 보기로 한다 . 



그림 13-12. Extension 페지 
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끝으로 [Extension Points] 페 지 이 다 . 여 기 에 는 이 끼 워 넣 기 가 제 공하는 확장점 을 
서술하지만 이번에는 사용하지 않기때문에 설명을 생략한다 . 구체적인것은 도움말을 참 
조하기로 한다 . 


제4절. 끼워널기 

끼워넣 기를 만들 때 제 일 먼저 결정하여 야 하는것은 자신의 끼워넣기와 Eclipse 가 
동기반을 어떻게 결합하겠는가 하는것 이 다 . 즉 차림 표띠 에 차림 표를 추가하는것과 도구 
띠에 단추를 추가하는 문제이다 . 그것이 정해지면 다음에 확장점을 찾는다 . 찾는 방법은 
도움말에 서 [Platform Plug-in Developer Guide] [Programmer Guide] -누 [Plug-in 
to Workbench] —[Workbench’ s Extension Points] 을 보는것이다 . 그러면 그림 
13-13 에 끼워넣기 가 진행된것을 볼수 있다 . 즉 도구띠는 그림 13-13 으로부터 [Action 
set actions] 라는것 을 알수 있 다 . 


Editor toolbar 
actions 


View action 


Action set 
/ actions 


Custom editor 



E ■■ 년 MyServlet 

□MyWeb 

images ： 

■■… _ .pfooed 
장 index ihtml 
^ sample 1. readme 



SECTION 1 

This text is a placeholder 1 for the hectic 
1.1 Subsection 

This text is a placeholder for the sut 
즈 . SECTION 2 

This text is a placeholder for the sect.ic 
a bit longer in order to span two lines. v 

< mi I >1~ 


Tasks Readme Sections 然、 N 、 


Content outliner 


Custom view 


그림 13-13. 작업대의 기본확장점 
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이 번에 는 [Action set actions] 에 대 하여 구체 적 으로 살펴 본다 . 

도말의 [Platform Plug-in Developer Guide] 구 [Reference]—[Extension Points Reference] 
에는 확장점 에 대 한 설명 이 있다 . 끼워넣기는 이 방법 에 따라 끼워 넣 어 야 한다 . 도움말 
의 [Extension Points Reference] 를 선택하여 오른쪽판의 작업 대 항목의 
[org.eclipse.ui.actionSets ] 를 읽 어본다 . 그러면 [API Reference ] 를 보면 끼워넣 
기를 끼워넣 어 야 할 대면이 [org.eclipse.ui.WorkbenchWindowActionDelegate ] 와 
[org. eclipse. 

ui. IworkbenchWindowPulldownDelegate] 라는것 을 알수 있 다 . 후자는 style 
속성값이 《 pulldown 》 인 경우에 끼워넣어야 한다(그림 13-14). 


Search: 




• |a|x 


Search scope: All topics 


Contents # < 冬 > B 

固 org.eclipse.help.base.luceneAnalyi 
[=i org.eclipse.search.searchPages 
固 org.eclipse.search.searchResultSo 
IB org.eclipse.search.searchResuItVk 
固 org.eclipse.team.core.fileTypes 
固 org.eclipse.team.core.ignore 
因 org.eclipse.team.core.projectSets 
居 org.eclipse.team.core.repository 
B org.eclipse.team.ui.configurationWi 
因 org.eclipse.team.ui.synchronizePai 
1=1 org.eclipse.team.ui.synchronizeWi; 
因 org.eclipse.ui.accelerat 아 Configure 
因 org.eclipse.ui.acceleratorScopes 
固 org.eclipse.ui.acceleratorSets 
[2l org.eclipse.ui.actionDefinitions 
因 org.eclipse.ui.actionSetPartAssoci 
r 】 BB 腎 Siff 


因 org.ec 
固 org.ec 
H) org.ec 
因 org.ec 
因 org.ec 
固 org.ec 
1=1 org.ec 
函 org.ec 
1=1 org.ec 
固 org.ec 
固 org.ec 
因 org.ec 
固 org.ec 
函 org.ec 


ipse.ui.activities 
ipse.ui.cheatsheets.cheatSI' 
ipse.ui.cheatsheets.cheats^ 
ipse.ui.commands 
ipse.ui.contexts 
ipse.ui.dec orators 
ipse.ui.dropActions 
ipse.ui.editorActions 
ipse.ui.editors 
ipse.ui.editors.annotationTyi 
ipse.ui.editors.documentPra 
ipse.ui.editors.markerAnnotc 
ipse.ui.editors.markerUpdatt 
ipse.ui.editors.templates 
ui p|pjnentEactnrii»s 
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API Information ： The value of the class attribute must be the fully qualified name of a class that implements 
org.eclipse.ui.IUorkbench¥indowActionDelegate or 

org. eclipse. ui. IUorkbenchUindowPulldownDelegate. The latter should be implemented in cases where 
II the style attribute has the value pulldown. This class is the handler responsible for performing the action. If the 
retarget attribute is true, this attribute is ignored and should not be supplied. This class is loaded as late as 
possible to avoid loading the entire plug-in before it is really needed. 

The enablement criteria for an action extension is initially defined by enablesFor, and also either selection or 
enablement. However, once the action delegate has been instantiated, it may control the action enable state 
directly within its selectionChanged method. 

It is important to note that the workbench does not generate menus on a plug-in's behalf. Menu paths must reference 
menus that already exist. 

Action and menu labels may contain special characters that encode mnemonics using the following rules: 

1. Mnemonics are specified using the ampersand character in front of a selected character in the translated 
text. Since ampersand is not allowed in XML strings, use &ainp ； character entity. 

If two or more actions are contributed to a menu or toolbar by a single extension the actions will appear in the reverse 
order of how they are listed in the plugin.xml file. This behavior is admittedly unintuitive. However, it was discovered 
after the Eclipse Platform API was frozen. Changing the behavior now would break every plug-in which relies upon the 
existing behavior. 

The selection and enablement elements are mutually exclusive. The enablement element can replace the 
selection element using the sub-elements otajectClass and objectState. For example, the following: 


class= r, org. eclipse.core. resources. IFile r, 
name= r, *. j ava rf > 

</selection> 


can be expressed using: 

<enableinent> 

<and> 

<objectClass name= 
<objectState name= 
</and> 

</enatolement> 


’org.eclipse.core.resources. IFile ,r /> 
’extension” value= ,r java ,r /> 


그림 13-14. 도움말의 API 정보 

Hello 끼워넣 기의 경우에 끼워넣 기명시 에서 확인해보면 style 속성 이 포함되 여있지 
않기때 문에 전자를 끼워넣는것 이 더 좋다(목록 13-3). 
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목록 13-3. 끼워넣기명시 원천쿄드의 extension 요소 

〈extension point=’’org. eclipse, ui. ac 付 onSets ”〉 

<actionSet 

label=”Sample Action Set" 
visible=’’true” 

id=”kp. ac. kut. example, hello. actionSet ”〉 

<menu label=’’Sample &amp ； Menu ? ' id=’’sampleMenu”> 
〈separator name=”sampleGroup’’> 

〈 /separator 〉 

</menu> 

<action 

label=’’&amp;Sample Action" 
icon=’’icons/sample, gif” 

class=”kp. ac. kut. example, hello, actions. SampleAction M 
tooltip=’’Hello，Eclipse world” 
menubarPath= M sampleMenu/sampleGroup M 
toolbarPath=”sampleGroup” 

id=”kp. ac. kut. example, hello, actions. SampleAction M > 

</action > 

</actionSet> 

〈/additional room 〉 


실제 로 [kp. ac. kut. example, hello, actions. SampleAction] 클 라스를 편집 기 에 서 
열어보면 [IworkbenchWindowActionDelegate] 대면을 실현하고있다는것을 알수 있다 . 

끼워넣기명시에는 어떠한 정보를 써넣어도 된다 . 이미 본 도움말의 
[org. eclipse. ui.actionSets] 의 확장점 참조서 에 [Configuration Markup] 이 라는 항목 
이 있다 . 여기에는 각 속성들이 무엇을 정의하고있는가를 설명하였다 . 그러나 너무 많아 
서 어느것이 정말 필요한것인지 알아보기가 힘들다 . 보통은 Hello 끼워넣기와 같은 견본 
에서 사용하는 속성을 그대로 사용해도 문제는 없다 . 그리고 도움말을 보면 사용방법을 
리해할수 있을것 이 다 . 

여기서는 차림표띠에 차림표항목을 추가하고 도구띠에 단추를 추가하는 방법에 대해 
약간 취 급하려 고 한다 . 우선 Hello 끼워넣 기 에서는 새 로운 차림 표항목을 작성한다 . 
menu 요소를 보면 label 속성 에 《 SampleMenu 》 라고 씌 여진 차림표항목이 정의되여 있 
다(목록 13-4). id 속성의 《 sampleMenu 》 는 이 차림표의 ID 이다 . 도움말을 보면 알수 
있듯이 path 속성이 씌여져있지 않기때문에 이 sampleMenu 는 새로 만드는 차림표로 
정의된다 . 
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목록 13-4. 끼워넣기명시 원천쿄드의 menu 요소 

<menu 

label=”Sample &amp；Menu 
id=’’sampleMenu ”〉 
〈separator 

name="sampleGroup n > 

〈 /separator 〉 

</menu> 


그 아래의 separator 요소는 sampleMenu 의 아래에 sampleGroup 이라고 하는 분 
리기호로 구별되는 그룹을 만든다 . 

이번에는 action 요소를 본다 . menubarPath 속성에《 sampleMenu/sampleGroup 》 
이 적혀 있다(목록 13-5). 이것은 이 동작을 sampleGroup 에 차림표항목으로 추가한다 
는것을 의 미 한다 . Runtime 작업 대를 실행시 키 면 label 속성 값 [Sample Action] 이 
[Sample Menu] 밑에 추가된다 . 이렇게 차림표띠에 동작을 추가할 때에는 
menuBarPath 속성 에 새 로운 차림 표의 경 로를 입 력 한다 . 

마찬가지로 도구띠에 단추를 추가할 때에 toolbarPath 속성에 단추를 추가하려는 도 
구띠 그롭을 입력 한다 . Hello 끼워넣기 에서는 [SampleGroup] 이 라는 미정의 도구띠 그룹을 
지 정하는것 으로 도구띠 에 새 로운 그룹을 추가한다 . 


목록 13-5. 끼워넣기명시 원천쿄드의 action 요소 

<action 


label= M &amp；Sample Action” 
icon="icons/sample, gif" 

class=’’kp. ac. kut. example, hello, actions. SampleAction” 
tooltips "Hello, Eclipse world” 
menubarPath= M sampleMenu/sampleGroup M 
toolbarPath="sampleGroup” 

id=”kp. ac. kut. example, hello, actions. SampleAction ”〉 
</action> 


도구띠 에 관계되는 속성 에는 그 외 에도 아이콘화상을 정의하는 icon 속성과 도구암 
시 를 표시 하는 tooltip 속성 이 있 다 . icon 속성 에 는 gif 파일 명 이 plugin, xml 파일 로부터 의 
상대경 로로 입 력된다 . 이 icon 속성을 삭제해 버리면 아이콘이 표시되지 않고 붉은 점으 
로 되 여버린다 . 

끝으로 IWorkbenchWindowActionDelegate 대 면을 실현 하여야 할 메 쏘드에 대 
하여 본다 . 
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. initO 

이 끼워넣기 가 초기화될 때 호출된다 . 여기서는 부모쉘 인 window 객체를 고속완충 
시켜 놓는다 . 

. selectionChanged 0 

작업대에서 선택되여 있던것이 달라지면 호출된다 . 선택되여 있던것의 정보를 인수 
로 가지 고 그것 에 의해 동작을 비 능동으로 할수 있 다 . 

. run() 

실제로 실행되는 동작을 서술한다 . 

. dispose 0 

완료될 때 호출된 다 . 자원 등의 후처리 를 서 술한다 . 

제5절. 끼워널기의 전용화 

계속하여 끼워넣기의 전용화를 진행한다 . Hello 끼워넣 기의 

《 kp.ac.kut.example.hello.actions.SampleAction 》 클라스를 확장하여 선택된 파일 
이 XML 일 때에만 Hello 끼워넣기의 run() 이 실행되게 해본다 . 

우선 SampleAction 을 확장한 클라스를 만든다 . [Package Explorer] 안에 서 
[kp.ac.kut.example.hello.actions ] 패키지를 마우스오른쪽단추로 찰칵하고 [New] — 
[Class] 를 선택 한다 . 그러 면 [New Java Class] 조수가 기 동하는데 이 름은 [MyAction ]， 
상위클라스는 [SampleAction] 으로 한다(그림 13-15). 그다음 [Finish ] 를 찰칵한다 . 




그림 13-15. 새로운 Java 클라스작성대화칸 
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다음으로 끼워넣 기명시의 action 요소안의 class 속성과 id 속성을 변경한다 . 지금까지 
는 [SampleAction] 이 였지 만 이 번에 는 [MyAction] 으로 한다(목록 13-6). 


목록 13-6. 끼워널기명시 원천쿄드의 action 요소(변경 후) 


<action 


label= f '&amp；Sample Action” 
icon’icons/sample, gif’ 

class=’’kp. ac. kut. example, hello, actions. MyAction” 
tooltips "Hello, Eclipse world" 
menubarPath="sampleMenu/sampleGroup M 
toolbarPath=’’sampleGroup” 

id=”kp. ac. kut. example, hello, actions. MyAction ”〉 
</action> 


MyAction 클라스를 편집 기 에 서 열 어 편집 한다 . 

먼저 SampleAction 의 메 쏘드를 재정의한다 . 차림 표띠 에서 [source] — 
[Override/Implement Methods] 를 선택하여 현시된 대화칸에서 재정의하는 메쏘드를 
선택하고 [OK] 를 누르면 자동적으로 재정의할수 있다(그림 13-16, 목록 13-7). 또한 
취미에 따라 메쏘드설명문도 추가할수 있다 . 
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목록 13-7. 재정의된 메쏘드 

public void dispose 0 { 
super, dispose 0; 

} 

public void init (IWorkbenchWindow window) { 
super, init (window); 

} 

public void run(IAction action) { 
super, run (action); 

} 

public void selectionChanged(IAction action, ISelection selection) { 
super. selectionChanged (action, selection) ； 


그러면 재정의한 메쏘드를 확장해본다 . 

처 음으로 선택된 파일을 취 하기 위 하여 selection 객체를 정의한다 . 여 기서 
selectionChanged 0 가 실행될 때마다 selection 객체를 갱신되게 한다 . 
private ISelection selection ； 

public void selectionChanged (IAction action, ISelection selection) { 
this. selection=selection : 
super. selectionChanged (action, selection); 

} 

이 번에 는 실행 되는 동작을 서 술하는 run 메 쏘드를 작성한다 . 처 음에 는 파일 이 선택 
되 여있는지 를 확인한다 . 그 방법 으로 selection 객 체 의 구체 례 가 IstructuredSelection 과 
일치 하는가를 조사한다 . 만일 일치 하지 않으면 되돌리기 하여 동작을 실행 하지 않는다 . 

if (this, selection == null || this, selection. isEmpty 0 

|| ! (this, selection instanceof IStructuredSelection)) { 
return ； 

}else{ 

//do nothing 

} 

다음에 파일을 취한다 . 코드를 보면 알수 있듯이 IstructuredSelection 안에 IFile 
을 취 한다 . 이미 전에 필요한 끼워 넣 기의 추가에서 [org.eclipse.core, resources] 를 
추가하였는데 이 끼워넣기는 IFile 등 자원계 렬의 처 리를 진행할 때 필요하다 . 

for (Iterator itr = ((IstructuredSelection) this, selection). iterator () ； 
itr. hasNextO ； 

){ 

Object target = itr. next 0; 
if (target instanceof IFile) { 

IFile file = (IFile)target ； 
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얻어 낸 파일을 검사하기 위한 메쏘드를 정의한다. 

private void variable(IFile file) throws Exception { 
InputStream is = file.getContentsO ； 
byte[] fileheader = new byte [5] : 
byte[] xmlheader = { ’<’，’?’， ’x’，’m’，T} 
is. read (fileheader); 
is.closeO ； 

for(int i = 0; i < 5; i++) { 

if ( ! (xmlheader [i] == fileheader [i])) { 
throw new java. lang. Exception () ； 


이상의 내용을 종합하면 목록 13-8 과 같다. 


목록 13-8. 확장한 메쏘드 

public void run(IAction action) { 

if (this, selection == null || this. selection. isEmpty 0 

|| ! (this, selection instanceof IStructuredSelection) ) { 
return ; 

} else { //do nothing 

} 

for (Iterator itr =( (IStructuredSelection) this, selection). iterator (); 

Itr. hasNextO ；) { 

Object target = itr. next 0; 
if (target instanceof IFile) { 

IFile file = (IFile)target； 
try { 

validate (file) ； 

} catch (CoreException e) { 
e. printStackTrace0 ; 
return； 

} catch (IOException e) { 
e. printStackT race 0 ； 
return； 

} catch (Exception e) { 

System, out. println(file. getiNfame()+” 는 XML 파일 이 아닙 니 다 . ") ; 
return； 

} 

} else { 
return； 
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System.out.println (，，선택한 파일은 모두 XML 파일입니다 .’’); 
super, run (action) ; 

} 

private void validate(IFile file) throws Exception { 
byte [] fileHeader = new byte [5] ； 
byte[] xmlHeader = {’<’ ， ’?’ ， ’x’ ， ’m’ ， T}; 

InputStream is = null ； 
is = file.getContentsO ； 
is. read (fileHeader); 
is.closeO; 

for(int HO ； i < 5 ； i++) { 
if (! (xmlHeader [i] == fileHeader [i])) { 
throw new java. lang. Exception ； 


편집한 결과를 보존하고 Runtime 작업대를 실행해본다(실행하기 전에 주의할것은 끼워넣기 
명 시 의 [Dependencies] 페 지 에 서 [Required Plug-ins] 에 [org. eclipse, core, resources] 가 
포함되 여 있는지 를 확인하는것 이 다 . ) . 그러 면 《 ."cannot be resolved or is not a type 》 
라는 오유가 나올수 있는데 오유행 왼쪽에 표시되 여있는 아이론을 찰칵하여 필요한 패 키 
지 를 반입한다 . 

import java. io. IOException ； 

import java. io. InputStream ； 

import java. util. Iterator ； 

import org. eclipse, core, resources. IFile ； 

import org. eclipse, core, runtime. CoreException ； 

import org. eclipse, jface. action. I Action ； 

import org. eclipse, jface. viewers. ISelection ； 

import org. eclipse, jface. viewers. IStructuredSelection ； 

import org. eclipse, ui. IWorkbenchWindow ； 

Runtime 작업대가 열리면 Navigator 보기에서 프로젝트를 만들고 그 안에 아무것도 
써 넣지 않은 빈 파일을 작성하여 시험해본다 . 빈 파일 file.txt 을 선택하여 [Hello, 
Eclipse world] 단추를 눌러 본다 . 아무런 동작도 진행 되 지 않고 그림 13-17 과 같이 끼 
워넣기개발투시의 조종탁에 《 file.txt 는 XML 파일이 아닙니다.》가 출력된다 . 
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Problems 

Error Log 

Tasks 

Properties 

Classic Search 

§ Console 然 ■ % 

LL 

면 ■ᅳ [] 

□ 

Hello [Run-time Workbench] /usr/java/jdkl.G.Q/bin/java (2005. 요 9 모진 10:15:13! 

file.txt 는 XKL 파일〔)1 마니다. 

爲 

因 = 







= 因 



그림 13-17. 조종탁에 ■보문이 현시 

이번엔 .project 파일을 선택하여 [Hello Eclipse world ] 단추를 눌러 본다 . 그러면 
그림 13-18 과 같이 [Hello 끼워넣기]대화칸이 나타난다 . 이때 끼워넣기개 발투시의 조종 
탁에 는《 선택 한 파일 은 모두 XML 파일 입 니 다.》가 출력 된다(그림 13-19). 


HeEEo Pbg-i 


ᅵ， Hello, Eclipse world 



그림 13-18. [ Hello 끼워널기]대화칸 


Problems 

Error Log 

Tasks 

Properties 

Classic Search 

§ Console 然 

■ ^ 

1 듦 1 LL 

변， ᄆ □ 

Hello [Run-time Workbench] /usr/java/jdk 1.6.CVbin/java (2005. 8 . 답 오전 1(3:15:13} 

선택된 파일은 모두 XML 파일입니다. 





A 

一 








= 因 


그림 13-19. 조종탁에도 틍보문이 현시 
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제6절. 끼워널기의 반출 

끼워넣 기의 반출은 단순하다 . 끼워넣기프로젝트를 선택 하고 차림 표에서 [Export] 을 
실 행 하면 된 다 . 구체 적 으로 도움말의 [PDE Guide] ᅳ [Getting Started] ᅳ [Basic 
Plug-in Tutorial] —[Deploying a plug-in] 를 참조하면 된다 . 여기서는 간단히 순서 
를 설 명한다 . 

끼워넣 기프로젝트를 선택 하고 마우스오른쪽단추를 찰칵하여 현시되는 차림 표에서 
[Export] 을 선택한다 . 현시 되 는 대 화칸에 서 [Deployable plug-ins and fragments] 
을 선택하고 [Next] 를 찰칵한다 . 



그림 13-20. 반출대화칸 

[Available Plug-ins and Fragments] 에 서 [kp. ac. kut. example, hello] 를 선 
택하고 [Export Option] 에 서 [a single ZIP file] 을 선택한다 . 그리 고 [File name] 
에 [/eclipse/kut/hello. zip] 를 입력 한 다음 [Finish] 를 찰칵한다 (그림 13-20). 
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제 14 장 . Eclipse RCP 

제 1 절 . Eclipse RCP 의 개요 


Eclipse 3.0 에서 는 RCP(Rich Client Platform: 다기 능의 뢰 기 가동기 반)기 능이 강 
화되였다 . Eclipse RCP 는 Eclipse 를 통합개발환경 (IDE) 의 가동기반으로 리용하던것으 
로부터 공통의 응용프로그람가동기반 (응용프로그람을 구축할 때 사용하는 기 반 ) 으로 확 
대하겠다는 시도에서 나온것 이 다 . 

Eclipse 는 현재 도 응용프로그람가동기 반으로 리 용할수 있지 만 응용프로그람가동기 반 
으로만 동작시키는데 필요없는 기능이 적지 않다 . 실례로 JDT(Java Development 
Tool:Java 개발도구 ) 이다 . 명백히 개발에는 JDT 가 필요하지만 사용자가 리용하는 응용프 
로그람에서는 필요가 없다 . 또한 IDE 에는 필수적인 본문편집기능도 사용자에게는 필요없 
는 기능으로 밖에 되지 않는다 . 

여 기서 《필요없는 기능을 빼 고 Eclipse 를 기동시키면 좋지 않은가》하는 착상이 생 
긴다 . 그러 나 Eclipse 2.x 까지의 판본에서는 IDE 가동기 반으로 설계되 여있으므로 다기 
능의뢰기응용프로그람을 실현하는 기능만을 떼여 내기가 곤난하다 . 그림 14_1 을 본다 . 
UI 부품부분에 IDE 가동기반으로 하여 필요한 Text (본문편집기 등 Eclipse 에서 제공하 
는 편집기의 조종부분)와 IDE 의 보기부분이 꽉 차있어 Text 부품과 IDE View 부품을 
빼낸다는것이 힘들다 . 



Runtime 


그림 14-1. Eclipse 2. x 까지의 구성방식 

이렇게 Eclipse 2.x 판본까지의 결함을 퇴치하기 위해 Eclipse 3.0 에서는 다기능의 
퇴기응용프로그람의 구축이 헐하게 구성방식이 변경되였다 . Eclipse 3.0 의 구성방식은 
그림 14-2 와 같다 . 
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그림 14-2. Eclipse 3.0 의 새로운 구성방식 

그림 14-2 를 보면 알수 있듯이 그림 14-1 에서 UI 부품에 들어가 있던 Text 부품과 
IDE View 부품들이 서로 분리되였다 . UI 부품은 응용프로그람의 가동기반으로 리용하기 
쉽게 범용적으로 만들었다 . 결국 Eclipse 의 작업대로부터 IDE 에 고유한 필요한 부분품 
의 의존을 없애고 일반적인 응용프로그람에서도 리용가능하게 되였다 . 결국 범용적인 작 
업대로 된것뿐이다 . 

Eclipse RCP 를 리용한 응용프로그람을 기동하는데는 Generic Workbench 와 
JFace, SWT, Runtime(OSGi) 가 있으면 된다 . 도움말이나 본문비교，본문편집기의 기 
능 등 Eclipse 부속의 끼워넣 기기능을 리용하고싶을 때 에는 끼워넣 기기능을 더 추가하면 
된 다 . 

기동에 필요한 부분품들이 아주 적어졌으므로 보통의 Eclipse 와 비교하면 기동시간 
이 짧고 응용프로그람자체의 동작도 가벼워 졌다 . 이 장에서는 실제로 Eclipse RCP 를 리 
용한 응용프로그람에 대하여도 설명하기때문에 보통의 Eclipse 와 속도를 비교할수 있다 . 

이 새로운 Eclipse 3.0 의 RCP 구성방식을 리용하면 보통의 업무응용프로그람의 가 
동기반으로 Eclipse 를 리 용할뿐 아니 라 개 발환경 으로도 쓸수 있 다 . 

실례로 통신쎈터의 응용프로그람을 Eclipse RCP 로 구축하였다고 하면 운영중에 고 
장이 생긴 경우 Eclipse RCP 응용프로그람에 끼워넣 기기구를 리용하여 오유수정환경을 
만들고 원 인을 찾아내 여 문제 를 처 리할수 있 다 . Eclipse 의 다음 판본에서 는 완전히 동적 
으로 끼워넣기를 추가할수 있게 할 예정 이 다 . 이 기능을 리용하면 응용프로그람을 재기 
동하지 않고 실례로 본 오유수정환경을 구축할수 있다 . 
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제 2 절 . Eclipse RCP 

RCP 라고 해도 그렇게 힘들기만 한것은 아니다 . 끼워넣기개발때 소개한 끼워넣기개 
발순서와 거의 같다 . 그래도 약간의 차이가 있으므로 주의를 돌리면서 RCP 개발순서를 
따라 해보기로 한다 . 

14.2.1. HelloRCP 응용프로그람의 개요와 준비 

제 일 먼저 만드는 견본은 [HelloWorld] 프로그람이다 . 그러 나 이 번 견본은 단순히 
빈(아무런 보기 도 편집 기 도 표시 되지 않는 ) 작업 대 를 띄 우는것 뿐이며 《 HelloWorld 》 조 
차 현시하지 않는다 . 그것 은 Eclipse RCP 를 리 용하는 응용프로그람 (RCP 응용프로그 
람)을 작성하는데 맞게 최 소한의 필요한 구성밖에 리 용하지 않기때 문이 다 . 그 최 소한의 
구성만으로 응용프로그람을 기동해보면서 Eclipse RCP 의 기본을 학습해본다 . 

먼저 [Plug-in Development ] 투시를 열어 본다 . 차림표띠의 [Window] ^ [Open 
Perspective] —[Other ] 를 선택 하면 [Select Perspective] 대 화칸이 열 린 다 . 그 안에 서 
[Plug-in Development ] 을 선택하고 [OK ] 를 찰칵하면 [Plug-in Development ] 투시 
가 열린 다 . 

14.2.2. 끼워넣 기 프로젝트조수의 사용 

Eclipse RCP 를 리용한 응용프로그람을 만들어 본다 . [Package Explorer ] 보기 에서 
마우스오른쪽단추를 찰칵하고 [New] —[Plug-in Project] 를 선택 하면 

[New Plug-in Project ] 조수가 기동한다 . 제일 먼저 나오는 [Plug-in Project ] 페지 
(그림 14-3 ) 에서 프로젝트이름은 《 SampleChapl4. 1 》로 하고 [Use default ] 와 
[Create a Java project ] 선택칸을 선택 한다 . 

[Alternate Format(For Advanced Users Only ) :형 식 변경 ( 전문가용 )] 그룹안에 
있는 [Create an OSGi bundle manifest for the plug-in (끼 워 넣 기 를 위 한 OSGi 묶 
음명시를 생성)]칸은 선택하지 않는다 . 이 선택항목은 Eclipse 3.0 부터 생긴것인데 끼 
워 넣기를 OSGi 대응끼워 넣기로 하기 위한《 Manifest. MF 》 라고하는 파일을 작성 할 때 
리용한다 . 다음 [Next ] 를 찰칵한다 . 그러면 [Plug-in Content] 대화칸이 나타난다 (그 
림 14-4). [Plug-in Properties ] 그룹안에 다음과 같은 값들을 넣는다 . 끼워넣기 ID 에는 
《 sample.hello 》， 끼워넣기판번호에는《 0.01 》，끼워넣기이름은 《 HelloRcp 》 으로 한 
다 . 끼워넣기제공자에는 《 KUT > 를 입력 한다 . [Runtime Library] 에는 《 HelloRcp. jar 》 
라고 입 력한다 . 또한 [Plug-in Class] 그룹에 있는 [Generate the Java class that 
controls the pulg-in’s life cycle] 칸을 이 번 RCP 응용프로그람에 서 는 사용하지 않으 
므로 선택하지 않는다 . 그리 고 형 판은 사용하지 않으므로 조수에서의 설정 은 여 기서 끝 
낸다 . [Finish] 를 찰칵한다 
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그림 14-3. 끼워 널기프로젝트작성 대화칸 




그림 14-4. 끼워널기내용대화칸 
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14.2.3. 필수끼워넣기의 추가 

다음으로 RCP 응용프로그람에 필요한 끼워넣 기를 추가한다. [Package Explorer ] 
보기에 있는 [ plugin . xml ] 을 두번 찰칵하여 열고 [ Dependancies ] 페지의 [Required 
Plug - ins (필수끼 워 넣 기 )] 령 역 에 있는 [ Add ] 를 누르고 ( org . eclipse . core , runtime } 
과 《 org . eclipse . ui 》 를 추가한다(그림 14-5). 



그림 14-5. Dependancies 페지 


14.2.4. RCP 응용프로그람에 필요한 클라스의 정의 

끼워넣기명시에 필요사항을 모두 서술하기 전에 먼저 클라스를 만든다. 그것은 끼워 
넣 기명시의 서술을 계속해 나가자면 클라스지 정 이 필요하기때문이 다. RCP 응용프로그람 
을 작성 하기 위하여 최소로 필요한 클라스는 다음의 3개 이다. 

① IPlatformRunnable 대면의 실현클라스 

IPlatformRunnable 대면의 실현클라스는 응용프로그람의 입구점으로 되는 클라스 
이다. 그것은 IPlatformRunnable 대면의 실현클라스의 run 메쏘드로부터 RCP 응용프 
로그람이 시작되기때문이다. 말하자면 run 메쏘드는 보통의 Java 클라스에서 main 메쏘 
드와 같은것 이 다. 

② WorkbenchAdvisor 추상클라스의 하위클라스 

Workbench Advisor 추상클라스의 하위 클라스는 다기 능의 뢰 기 (Rich client ) 의 기 반 
으로 되는 작업대의 설정을 진행하는 클라스이다. RCP 응용프로그람은 반드시 투시가 한 
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개 이상 필요하다 . 이 투시를 호출하는 역 할을 WorkbenchAdvisor 추상클라스의 하위클 
라스가 하는것이다 . 그래서 이 클라스는 응용프로그람의 수명을 관리하는 역할을 한다 . 
결국 RCP 응용프로그람동작중의 화면에 관계되는 사건이 일어날 때마다 기동되는 메쏘드 
가 정의된다 . 

구체 적 인것 은 이 장의 3 절 에 서 설 명한다 . 

③ IPerspectiveFactory 대면의 실현클라스 

RCP 응용프로그람은 반드시 한개 이 상의 투시 가 필요하다는것 을 우에 서 설명하였 다 . 
바로 IPerspectiveFactory 대면의 실현클라스가 그 투시를 만드는 역할을 하는 클라스 
이다 . 

그러 면 차례 로 실제 클라스들을 작성하여 보기 로 한다 . 아래 에 정 의하는 클라스들은 
[Package Explorer ] 보기의 [SampleChapl4.1 ] 프로젝트의 [sample, hello ] 패키지에 
작성 한다 . 

HelloRcpApplication 들라스 (IPlatformRunnable 대 면의 실현믈라스 ) 

목록 14-1. HelloRcpApplication 클라스 

package sample.hello ； 


import org. eclipse, core, runtime. IPlatformRunnable ； 

import org.eclipse, swt.widgets.Display ； 

import org. eclipse, ui. PlatformUI ； 

import org. eclipse, ui. application. WorkbenchAdvisor ； 

public class HelloRcpApplication implements IPlatformRunnable { 
public Object run (Object args) { 

WorkbenchAdvisor WorkbenchAdvisor = new HelloRcpAdvisorO : 
Display display = PlatformUI. createDisplayO ； 
try { 

int returnCode = PlatformUI.createAndRunWorkbench 
(display, WorkbenchAdvisor); 
if (returnCode == PlatformUI. RETURN_RESTART) { 
return IPlatformRunnable. EXIT_RESTART ； 

} else { 

return IPlatformRunnable. EXIT—OK; 

} 

} finally { 
display, dispose0; 
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RCP 응용프로그람의 기 동점 을 정 의하는 클라스에서 는 IPlatformRunnable 대 면의 
run 메쏘드를 적용할 필요가 있다 . 그 run 메쏘드를 적용한것이 목록 14-1 이다 . run 메 
쏘드안에 서 는 제 일 처 음 WorkbenchAdvisor 객 체 의 구체 례 를 생 성 한다 . 다음 
PlatformUI 클라스의 createDisplay 메 쏘드를 사용하여 Display 객 체 를 생 성 한다 . 

이 2 개의 workbenchAdvisor 구체 례와 display 구체 례를 리 용하여 PlatformUI 클라스의 
createAndRunWorkbench 메쏘드로 작업대를 기동한다 . 작업대가 어떠한 리유로 완료될 때 
까지 createAndRunWorkbench 메쏘드는 계속 실행되여있다 . 어떠한 리유로 작업대가 완료 
된 경우 createAndRunWorkbench 메쏘드는 아래의 값들중 하나를 귀환값으로 돌린다 . 

PlatformUI. RETURN.OK 보통완료 

PlatformUI. RETURN.RESTART 재 기 동요구에 의 한 완료 

PlatformUI. RETURN_UNST ART ABLE 작업대 개 시 실패 

PlatformUI. RETURN_EMERGENCY_CLOSE 이 상완료 

이리한 정수들은 Java 편집기상의 출현위치에서 Ctrl 건을 누르면서 마우스지적자를 
정수에 대 고 찰칵하면 정의되 여 있는 부분에 로 이 행할수 있는것들이 다 . 이행한 정의부에 
설명 문이 있으므로 한번 읽 어본다 . 

run 메쏘드의 귀환값은 IPlatformRunnable 대면에 정의된 정수 EXIT_OK, EXI 
T_RESTART, EXIT_RELAUNCH 중의 하나이 다 . 우의 코드에는 createAndRun 
Workbench 메 쏘드의 귀 환값이 PlatformUI. RETURN_RESTART 인 경 우에 IPlatfo 
rmRunnable.EXIT_RESTART 를，그렇지 않은 경우에는 IPlatformRunnable. EXI 
T_OK 를 run 메쏘드의 귀환값으로 되돌린다 . 

작업대가 완료되여도 SWT 의 Display 객체가 처리되는것이 아니기때문에 반드시 
Display 객체의 dispose 메쏘드를 호출한다 . 이 Display 클라스는 SWT 에 정의되 여있는 
클라스로서 화면에는 아무것도 표시하지 않지만 구체례가 생성되면 조작체계로부터 여러 
가지 GUI 자원을 획득한다 . display 객체의 disposeO 메쏘드를 호출하여 자원을 해방하는 
것 이 SWT 에 서 류의 할 점 이 다 . 

HelloRcp Ad visor 클라스 (Workbench Ad visor 추상클라스의 하위 클 라스 ) 

Workbench Advisor 클라스의 하위 클라스는 getlnitialWindowPerspectivelcH 쏘 
드를 적용할 필요가 있다 . 아래의 getlnitialWindowPerspectiveld 메쏘드(목록 14_2) 
에서는 작업대에 필요한 투시의 ID 문자렬을 되돌린다 . 
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목록 14-2. HelloRcpAdvis 아클라스 

package sample.hello ； 

import org. eclipse, ui. application. WorkbenchAdvisor ； 

public class HelloRcpAdvisor extends WorkbenchAdvisor { 
public String getlnitialWindowPerspectiveld 0 { 
return "sample, hello. HelloRcpPerspective"; 


HelloRcpPerspective 클라스 (IPerspectiveFactory 대면의 실현클라스 ) 
IPerspectiveFactory 대면을 실현한 클라스는 createlnitialLayout 메쏘드를 적용 
할 필요가 있다 . 보통은 이 메쏘드안에서 보기나 편집기 등의 작성을 하지만 이번에는 
최 소판임 으로 아무것 도 처 리하지 않는다 (목록 14-3). 

목록 14-3. HelloRcpPerspective 클라스으 I 선언 

package sample, hello ； 

import org. eclipse, ui. IPageLayout ； 
import org. eclipse, ui. IPerspectiveFactory : 


public class HelloRcpPerspective implements IPerspectiveFactory { 
public HelloRcpPerspective0 { 

/* default constructor */ 

} 

public void createlnitialLayout (IPageLayout layout) { 


이상 클라스의 작성을 끝냈다 . 실제로 견본응용프로그람의 개요에서 설명한것처럼 
단순히 빈 작업 대 를 기 동하기 위한 응용프로그람이 지 만 그렇 게 간단하지 는 않다 . 

14.2.5. 끼워넣기명시에서 투시정의 

Eclipse 의 다기 능의 뢰기 응용프로그람에 서 는 최 소 한개 이 상의 투시 가 필요하다 . 투 
시 를 정 의 하기 위 해 확장점 [org. eclipse, ui. perspectives] 를 확장한다 . 

[Package Explorer ] 보기 에서 [SampleChapl4.1] 프로젝트의 plugin.xml 을 두번 
찰칵하여 다시 끼워넣 기명시를 열고 [Extensions ] 페지를 펼친다 . [Add ] 를 찰칵하여 확 
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장점 [org. eclipse, ui. perspectives] 를 추가한다 . 그다음 [All Extensions] 령 역 안의 
[org. eclipse, ui. perspectives] 에서 마우스오른쪽단추를 찰칵하여 [New] — [perspective] 
를 선택한다 . 그러면 오른쪽에 [Extension Element Details] 구역이 나타난다 . 

[Extension Element Details] 안에 서 “Perspective” 의 속성 들인 name, class, 
id 를 설정한다 . 처음에 투시를 정의하는 클라스를 [Browse] 단추를 찰칵하여 선택한다 . 이 
미 작성한 HelloRcpPerspective 클라스를 선택한다 . 선택하면 HelloRcpPerspective 클라 
스의 완전한 이름이 표시된다 . 이 이름을 그대로 id 값으로 하여 사용한다 . name 에는 
《 HelloRcpPerspective 》 라고 입력한다(그림 14_6). 



그림 14-6. 끼워널기명시에서 투시정의 


14.2.6. 끼워넣기명시에서 응용프로그람의 정의 

끼워넣기명시에서 응용프로그람의 정의를 진행한다 . 응용프로그람의 정의는 

[org. eclipse, core, runtime, applications] 확장점 을 확장하여 작성 한다 . 

[Extensions] 페 지에서 [All Extensions] 의 [Add] 를 찰칵하여 
《 org.eclipse.core, runtime.applications 》 를 추가한다 . 거 기서 [Extension Details] 
의 ID 에 《 HelloRcpApplication 》 을 입 력 한다 . 여 기서 입 력 하지 않으면 RCP 응용프로 
그람을 실 행할수 없으므로 반드시 입 력한다(그림 14-7). 
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그림 14-7. 끼워널기명시에서 응용프로그람의 정의 



그림 14-8. 끼워넣기명시에서 응용프로그람의 정의 
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다음 [All Extensions] 에 서 [org. eclipse, core, runtime, applications] 를 마우스 
오른쪽단추로 찰칵하고 [New] —[application] 을 선택 한다 . 다음 [application] 을 오른 
쪽찰칵하고 [New] ᅳ [Run] 을 선택한다 . 그러면 [Run] 요소의 [Extension Element Details] 가 
표시되는데 먼저 run 메쏘드를 정의한 클라스 [sample.hello.HelloRcpApplica 仕 on] 을 선택 한 
다(그림 14-8). 이 클라스는 IPlatformRunnable 대면을 실현하고있 다 . 

이상 RCP 응용프로그람을 동작시키는 최소한의 끼워넣 기명시 정의 가 끝났다 . 끝으 
로 [plugin.xml] 페지를 본다 . 이 페지 에서는 끼워넣기명시의 원천코드를 볼수 있다(목 
륵 14-4). 

목록 14-4. HelloRcp 응용프로그람의 끼워널기명시 

<?xml version="l. 0 M encodings M UTF-8 M ?> 

<?eclipse version=”3.0”?> 

<plugin 

id=”sample. hello" 
name=’’HelloRcp” 
version=’’0. 01” 

provider-name="Rich Client Task %providerName"> 


〈 runtime 〉 

<library name= n HelloRcp. jar”> 

〈export name=’’*7> 

〈/library > 

</runtime 〉 

〈 requires 〉 

〈import plugin=”org. eclipse, core, runtime ’’/〉 

〈import plugin=”org. eclipse, ui ’’/〉 

</requires 〉 

〈extension 

id= "Hel 1 o R cp App 1 ication" 

point=”org. eclipse, core, runtime, applications ”〉 
〈 application 〉 

<run class=’’sample. hello. HelloRcpApplication M /> 
〈 /application 〉 

〈 /extension 〉 

〈extension 

point=”org. eclipse, ui. perspectives ”〉 

〈perspective 

class= n sample. hello. HelloRcpPerspective" 
name= "Hel loRcpPerspective’’ 
id=”sample. hello. HelloRcpPerspective ”/〉 
〈 /extension 〉 

</plugin> 
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14.2.7. RCP 응용프로그람실행 

견본응용프로그람을 실행 시 켜 본다 . [Package Explorer] 보기에서 

[SampleChapl4.1] 프로젝 트를 마우스오른쪽단추로 찰칵하고 [Run] ᅳ [Run] 을 선택 한 
다 . [Run] 대화칸이 표시되는데 [Configuration] 에 있는 [RuntimeWorkbench] 를 
선택한 상태 에 서 왼쪽밑 에 있는 [New] 를 찰칵한다 . 그리 고 이 대 화칸의 제 일 웃단에 
있는 [Name] 에 《 HelloRcp 》 를 입력한다 . 다음 [Run an application] 칸을 선택하고 
《 sample, hello.HelloRcpApplication 》 을 선택 한다(그림 14-9). 



그림 14-9. RCP 응용프로그람의 실행 (1 단계) 

[Run] 대화칸의 [Plug-ins] 래브를 선택하고 [Choose plug-ins and fragments to 
launch from the list (기동하는 끼워넣 기와 단편화실례를 목록에서 선택)]단추를 선택 
한다 . 그러면 [Available plug-ins and fragments (사용가능한 끼워넣 기 및 단편화 )] 
안에 계 층구조가 생긴다 . 아래의 순서 로 기동에 필요한 최소한의 끼워넣 기를 선택한다 
(그림 14-10). 
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그림 14-10. RCP 응용프로그람의 실행 (2 단계) 

① 먼저 [Deselect All] 를 찰칵한다 . 

② sample.helloCO.0.1 ) 을 선택한다 . 

③ [Add required plug-ins ] 를 찰칵한다 . 

[Run ] 대화칸의 오른쪽 아래에 있는 [Run ] 를 찰칵하면 응용프로그람이 기동한다 
(그림 14-11). 이미 언급된것처럼 그 어떤 보기도 편집기도 없는 작업대가 기동한다 . 



그림 14-11. RCP 응용프로그람의 실행 

이 제 까지 RCP 응용프로그람의 기 초에 대 하여 설명하였 다 . 다음은 본격 적 인 RCP 응 
용프로그람인 RSS 열 람응용프로그람의 작성 을 진행한다 . 
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제 3 절. Eclipse RCP 를 리용한 RSS 열람응용프로그람 

14.3.1. 견본응용프로그람의 개요 

그러면 실제로 Eclipse RCP 를 리용하여 견본응용프로그람을 시험해본다 . RSS 열람 
이 라는것 은 Web 거 점 의 갱 신상태 나 개 요가 서 술되 여있는 RSS 파일을 Web 로부터 얻 어 


여러가지 거점의 갱신상태를 검사하거나 
관찰할수 있는 응용프로그람이다 . 

RSS 열람응용프로그람을 가동시키려면 
RSS 파일 을 Web 에 서 URL 을 지 정하여 얻 
어야 한다 . 이 장에서는 처음에 견본응용 
프로그람의 개 요를 설명한 후에 견본프로 
젝 트를 반입한다 . 

다음은 견본응용프로그람을 실제로 실 
행 하여 응용프로그람의 거 동을 관찰한다 . 
정적인 원천코드가 어떠한 관계에 있는가 
를 설 명한다 . 

이 견본응용프로그람에 서 는 JFace, 
SWT 등의 API 를 많이 사용하고 있지만 
Eclipse RCP 의 해설에 기본을 두고 JFace, 
SWT 등에 대한 구체적인 설명은 략한다 . 
상세한 정보가 필요한 경우 Eclipse 의 API 
문헌， eclipse.org 의 공식문헌 등을 참조한 
다 . 

14.3.2. 견본응용프로그람의 구성 

SampleChapl4. 2 프로젝 트를 생 성 한 
다 . 그림 14-12 와 같은 프로젝트구성으로 
되도록 하는것이 목표이다 . 여기서는 기본적 
으로 설명하려는 부분에 대한 코드만을 서술 
하였다 . 작성방법에 대하여는 이 책의 
[3.1.3 프로젝트의 작성]에서 설명되였으므 
로 참조한다 . 


▽ 낮 SampleChapl4i2 
t> 0 src 
▽ Q3 s re/main 

▽ rctf.rssr 

t> 0 E ntryV iewJ av a 

\> [T| E ntry V i ewC ontent P rov ider j av a 

t> 0 E ntry V i e wLabe IP rejv i de r.j av a 

t> [T| FeedT reed ontent Provider-java 

t> 12) F ee dT reeLabel P rav i d e r.j av a 

[> [Zl Feed Vi ew.j av a 

[> [T] Feed Vi ewS orter.j av a 

I> [T] Hi story M an ager.j av a 

t> [T] Main Pers pe-ctive .j av a 

t> [T| P refe re nee.java 

j> [T| Rs s E rcjws er.j av a 

t> 0 Rs s rAdv i sor.j av a 

t> [T] RssrAp plication Java 

|> 臣 ] Rs s rP I ug i n .j av a 

t> {T\ Rs s rP referen ce P age .j av a 

t> Si UriEditorlin put java 

▽ 면 rctf.rssr.model 

j> [J] A bstractN ode j av a 
I> 0 Feed .j av a 
I> [J] FeedG rou p.j av a 
t> S] Fe e d M an ager.jav a 
[> [T| Node.java 
t> ~i jcJorrs.jar 
t> G log4j-1.2.S.jar 
t> rome-Hjar 

t> Pi ug~i n De pendencies 

t> ^iJRE System Library [jdkl.6.0] 
t> &doc5 
[> &etc 
[> 경시 cons 

© build.properties 

4 남 plug i nx ml 

그림 14-12. 견본응용프로그람의 프로젝트 구성 
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14.3.3. 견본응용프로그람의 실행 

먼저 견본응용프로그람이 완성된 경우에 프로그람의 실행방법을 서술한다 . 
[Package Explorer] 보기 의 《 SampleChapl4. 2 》프로젝 트를 오른쪽단추로 찰칵하고 
[Run] ᅳ [Run] 을 선택한다 . 그러 면 [Run] 대 화칸이 나타난다 . [Run] 대 화칸안의 
[Configuration] 에서 [Run-time Workbench] 를 선택하고 왼쪽아래의 [New] 를 찰칵 
한다 . 그리고 [Run] 대화칸의 제일상단에 있는 [Name] 에 〈〈 RSSR 〉〉 라고 기입한다 . 마 
지 막으로 [Run an application] 단추를 선택 하고 내 리펼침목록으로부터 
《 rctf. 代 sr.RSSR 》 를 선택한다(그림 14-13). 


Create, manage, and run configurations 

Create a configuration to launch an Eclipse workbench. 


■■하프 


Configurations: 

B Java Applet 
[S Java Application 
Ju JUnit 

jr JUnit Plug-in Test 
# Run-time Workbench 
參 HelloRcp 



Name: 



I M= Arguments -, Plug-ins | ^Tracing | Configuration | . Source |> 


Workspace Data 


Location: /root/runtime-workspace | v | 「 

Browse... 

□ Clear workspace data before launching 

因 



Program to Run 

[ (j) Run an application: kctf.rssr.RSSR | v | 



Restore Defaults 


Apply^Revert 



Run 


][ 


Close 



그림 14-13. 견본응용프로그람의 실행 (1 단계) 

다음 [Run] 대화칸의 [Plug-ins] 래브를 선택하고 [Choose plug-ins and 
fragments to launch from the list] 단추를 선택 한다 . 그러 면 [Available plug-ins 
and fragments] 안에 계 층구조가 생 긴다 . 아래 의 순서 로 하면 기동에 필요한 최 소한의 
끼워넣 기를 자동적 으로 선택한다(그림 14-14). 

① [Deselect All] 를 찰칵한다 . 

② rctf. rssr(0. 0.1) 을 선택 한다 . 

③ [Add required plug-ins] 단추를 찰칵한다 . 

[Run] 대화칸 오른쪽아래에 [Run] 를 찰칵하면 응용프로그람이 기동한다 . 
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그림 14-14. 견본응용프로그람의 실행 (2 단계) 

14.3.4. 견본응용프로그람의 사용방법 

그림 14-15 와 같은 화면이 나타나면 기동이 성공한것이다 . 이 응용프로그람에는 
RSS 열 람투시 에서 차림표띠， [Feed] 보기， [ 기사]보기 가 구비되 여 있다 . 



차림표띠 


RSS 열 람투시 


그림 14-15. 견본응용프로그람의 기동화면 
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먼저 RSS 제공을 그룹화하기 위해 서류철을 주가한다 . [Root ] 를 선택하고 [Feed] 
보기의 [New folder ] 추가단추를 누르면 [ “Root” 에 등록부추가]대화칸이 현시되는데 
입력란에 〈〈 IT 새소식》이라고 쓰고 [OK ] 를 찰칵한다(그림 14-16). 그러면 [Feed ] 보기 
에 [IT 새 소식 ]이 라는 이 름의 등록부아이 콘이 추가된다 . 



【새 토운 둥록부추가1 단추률 누르면 
[■■ Roof 1 에 둥류부추가]대화창이 香다. 


그림 14-16. 등록부의 추가방법 

다음으로 실제 로 RSS 의 제 공을 추가해본다 . 이 미 작성한 [IT 새 소식 ] 등록부를 선택 
하고 [Feed] 보기 의 [New Feed] 단추를 찰칵한다 . [ “IT 새 소식 ” 에 제 공추가 ] 대 화칸이 
현시 되 는데 본문마당에 아래 와 같은 URL 을 입 력한다(그림 14-17). 

http : / / www. theserverside. com/rss/theserverside-rss2. xml 

[OK ] 를 누르면 [Feed ] 보기에 새로운 아이콘과 RSS 제공의 URL 이 표시된다 . 
URL 을 두번 찰칵하면 [ 기사]보기에 제공되여있는 새소식의 기사일람이 현시된다 . 기사 
일 람으로부터 한개 기 사를 두번 찰칵해본다 . 자동적 으로 Web 열 람기 가 뜨고 방금 두번 
찰칵한 기 사내 용이 서 술되 여있는 Web 페지 가 현시된다 . 
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그림 14-17. RSS 제공의 추가방법 


제4절. 견본응용프로그람의 원천쿄드해설 


Ecllipse RCP 를 리용한 응용프로그람에서도 보통의 끼워 넣기개 발과 개 발순서 가 달 
라지지 않았다 . 그러나 다음의 두가지 점에서는 Eclipse RCP 의 응용프로그람이 보통의 
끼워넣기개 발과 차이난다 . 

• 반드시 기 정 투시 를 정 의하여 야 한다 . 

• 추상클라스인 WorkbenchAdvisor 를 계승한 클라스가 득 한개 필요하다 . 


14.4.1. plugin.xml 

plugin.xml 에 끼워넣 기명시를 서술한다 . 

여 기서는 기정의 Eclipse 끼 워 넣 기 확장점 에 대 하여 확장을 정의 한다 . 

앞에서 견본응용프로그람은 RSS 열람투시우에 차림표띠， [Feed] 보기， [ 기사 ] 보기， 
Web 열 람기 (SWT 열람기)편집기 가 구비된 구성을 하고있다고 했다 . 어째서 Web 열 람기 
(SWT 열람기)편집기라고 썼는지 리해하기 힘들수도 있다 . 이 RCP 응용프로그람에서는 
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Web 열 람기 를 편집 기 로，즉 Eclipse 에 서 편집 기 용 끼 워 넣 기 (org. eclipse, ui. editors) 를 
확장한 끼워넣 기로 취급한다는것 이 다. 

그러면 Web 열람기 (SWT 열람기)의 의미는 무엇인가. 이번에 리용하는 열람기는 
SWT 열 람기 라고 부르는 Web 열 람기 이 다. 이 SWT 열 람기 는 SWT 에 정 의 되 여있는 
Browser 클라스를 리용하고있다. 이 Browser 클라스가 하는 일은 아주 간단한데 SWT 
에 들어 있 는 Win32 OLE (Object Linking and Embedding) 를 호출하여 Internet 
Explorer 의 화면을 SWT 의 부분품우에 붙여놓는것 이 다. 기 본적 으로 사용자가 정의하 
는 투시는 org. eclipse, ui. perspective 에 대 한 확장，보기는 org. eclipse, ui. views 에 
대 한 확장，편집기는 org.eclipse.ui.editors 에 대 한 확장으로 끼워넣 기명시로 정의한 
다. 그리고 개개를 확장점에 정의된 대면을 실현하는 형식으로 클라스를 작성하고 끼워 
넣 기명시 에 서술한다. 목록 14-5 를 본다. 이 목록에는 [Feed] 보기의 끼워넣 기명시를 
서술하였다. 

목록 14-5. plugin . xml 에서 보기의 확장정의 

〈extension 

point=”org. eclipse, ui. views "〉 

<view 

allowMultiple= "false” 
class="rctf. rssr. Feed View" 
category=’’rctf. rssr M 
name=’’ 제 공” 

id=”rctf. rssr. FeedView ? '/> 


extension 요소의 point 속성에 확장점을 서술하고 view 요소안의 class 속성에 확장 
점에서 정의된 대면을 실현한 클라스의 이름을 서술한다. 일반적으로 Id 속성에는 보통 
class 속성과 같은 이름을 서술하는것 이 좋다. allowMultiple 속성으로는 보기를 여 러개 
펼 치 겠는가 아니 면 하나만 펼 치 겠는가를 설정한다. false 로 지 정하면 투시안에 한개 의 
보기밖에 둘수 없다. category 속성은 여 러개의 보기를 묶어서 취급할 때 지정한다. 

우의 plugin.xml 의 내용은 plugin.xml 용편집기로 편집할수 있다. 한번 plugin.xml 
의 내용이 어떻게 되 여있는지 보아두는것 이 좋다. Eclipse 의 끼워넣기를 작성 할 때는 그냥 
본따는 기분으로 하는것도 큰것이다. 기존의 끼워넣기에서 비슷한 기능을 찾아 그 
plugin, xml 의 해당부분을 복사 및 붙여넣기하여 클라스의 실현도 흉내낼수 있다. 내용을 
한번 보아두지 않으면 어떻게 plugin.xml 의 내용을 복사 및 붙여넣기하면 좋은지도 알수 
없게 되고말기때문에 한번 내용을 보아둔다. 목록 14-6 은 필수끼워넣기의 정의이다. 이 끼 
워넣기에서 필요한 끼워넣기 ID 를 서술한다. 이 RCP 응용프로그람에서는 3 개의 끼워넣기 
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( org . eclipse , core , runtime } ， ( org . eclipse , ui 》， ( org . eclipse , jface } 이 필수끼 워 
넣기 이 다. Eclipse 의 끼워넣기기동조수로부터 가 아니 라 독립형 으로 Eclipse RCP 응용프로 
그람을 기동하는 경우 다른 필요한 끼워넣기 ( org . eclipse . update.configurator 등)가 있 
다는데 주의한다. 

목록 14-6. 필수끼워널기의 정의 

〈 requires 〉 

〈import plugin =’’ org . eclipse , core , runtime ”/〉 

〈import plugin =’’ org . eclipse . ui ，’/> 

〈import plugin =” org . eclipse . jface "/> 

</ requires 〉 


그림 14-18 은 이 번 RCP 응용프로그람에 서 사용하는 서 고이다. 작성할 때 필요하므 
로 plugin . xml 에 서술한다. 아래에서 이번 견본응용프로그람에서 사용하는 서고를 간 
단히 설 명한다. 

Log 4 J 는 Jakarta 프로젝트에서 작성한 로그를 위한 서고이 다. 프로젝트 등에서 실제로 사 
용된적이 많다. 상세한 사용방법에 대하여는 《 http :// logging . apache . org / log 4 j / docs /》 를 
참조한다. 

JDOM 은 XML 의 해석을 쉽게 하기 위한 서 고이다. 일반적 으로 DOM , SAX 의 실 
현인 Xerces 를 리용하는것 이 많다고 볼수 있지만 DOM , SAX 는 쓰기 쉬운 API 라고 말 
할수는 없다. JDOM 은 그런 측면에서 DOM , SAX 와 비교하면 아주 쉽게 다룰수 있는 API 
를 가진 서 고라고 말할수 있다. JDOM 의 상세 한 내용은 《 http :// www . jdom . org 》 를 참 
조한다. 

Rome 는 XML 문서로 인터네트로부터 얻을수 있는 RSS 제공을 간편하게 다루 
기 위 한 서 고이다. RSS 제 공을 다루기 위한 서 고는 대 단히 많지 만 이 번에는 비 교적 
가볍 고 쓰기 쉬 운 Rome 을 선택하였 다. 구체 적 인 사용방법 은 
《 http :// wiki . java . net / bin / view / Javawsxml / Rome 》 을 참조한다. 

plugin . xml 의 서술에서 해설할 부분은 많지만 아래에서 원천코드와 관련이 있는 
부분만을 추려 서 설 명한다. 
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그림 14-18. 끼워널기에서 사용하는 서고 


14.4.2. RssrApplication.java 

Eclipse RCP 응용프로그람을 작성하는데는 확장점에 있는 org . eclipse . core , runtime , applica 社 ons 에 
대 하여 끼 워 넣 기 명 시 에 org . eclipse , core , runtime , applications 를 확장하는 등의 선 언 
을 서술하고 (그림 14-19)，확장점 에 정의되 여있는 대면인 IPlatformRunnable 을 실 
현하는 클라스를 정의할 필요가 있다. 실현하는 이 대면은 [Extension point 
descrition ] 의 [API Information ] 에 서 술되 여 있 다. 
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그림 14-19. 끼워넣기명시에 대하여 
org.eclipse.core.runtime.applications2l 확장선언 
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목록 14-7. RssrApplication.java 의 class 선언부 

public class RssrApplication implements IplatformRunnable { 


이 클라스에서 중요한것은 run 메쏘드의 적용이다. 실제로 RCP 응용프로그람이 기 
동되면 처음에 메쏘드가 호출된다. 이 run 메쏘드에 동작내용을 서술한다. 

목록 14-8. RssrApplication.java 에서 run 메쏘드의 적용 

public Object run (Object args) throws Exception { 
initLog4j(); 

WorkbenchAdvisor workbenchAdvisor = new RssrAdvisorO ； 

Display display = PlatformUI.createDisplay 0 ； 

try { 

int returnCode= PlatformUI.createAndRunWorkbench 

(display, workbenchAdvisor); 

if (returnCode == PlatformUI. RETURN_RESTART) { 
return IPlatformRunnable. EXIT_RESTART ； 


return IplatformRunnable. EXIT_OK； 
} finally { 

if (display != null) { 
display, dispose0; 


run 메쏘드에서는 처음에 log4j 를 초기화하고 WorkbenchAdvisor 의 대면과 SWT 
의 Display 클라스의 대면을 생성한다. 이것을 리용하여 try 구문안에서 실제 로 작업 대를 
기동하며 귀환코드를 얻는다. 

최종적으로 finally 구문안에서 Display 클라스의 대면이 처리되도록 하고있다. 
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14.4. 3. RssrAdvisor. java 

목록 14-9 를 보면 알수 있듯이 RssrAdvisor 클라스는 Eclipse RCP 응용프로그람을 작 
성할 때 추상클라스인 WorkbenchAdvisor 클라스를 계승하고있다 . WorkbenchAdvisor 
클라스는 Eclipse RCP 에서 가장 중요한 클라스이므로 WorkbenchAdvisor 를 계승한 
RssrAdvisor 와 같이 해설한다 . 

목록 14-9. RssrAdvis 아클라스의 선언부 

public class RssrAdvisor extends WorkbenchAdvisor { 


Workbench Advisor 클라스는 작업대，작업대창문의 초기화도 하고 열기도 하는 등 
수명 에 관한 사건을 처 리하는 메 쏘드의 집 합이라고 할수 있 다 . 

그림 14-21 ，표 14-1 ，표 14-2 ，표 14-3 에서 기본적 인 메 쏘드를 참조한다 . 
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그림 14-20. 작업대의 수명에 관한 메쏘드 
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표 14-1. 

작업대의 수명사건에 관한 갈구리 ( hook ) 메쏘드 


메쏘드이 ■ 

설 명 

인 수 

Initialize 

초기화처리용 메쏘드이다. 제일 처음에 호출된다. 

IWorkbenchC 


지령행인수의 해석，화상 및 아이콘의 준비와 같은 
처 리 등에 사용한다. 

onfigure 

preStartup 

초기화처 리후 첫 창문이 열리기 전에 호출되는 메 
쏘드이다. 처음에 어느 편집기와 보기를 열겠는가 
를 결정하는 등의 처리에 사용한다. 


postStartup 

모든 창문이 열린 다음 사건순환이 시 작되 기 전에 
호출되는 메쏘드이 다. 자동적으로 프로쎄스를 개시 
하는 처 리 나 암시 문의 표시 처 리 등에 사용한다. 


preShut 

사건순환이 완료된 다음 창문이 모두 닫기기 전에 


down 

호출되 는 메 쏘드이 다. 


postShut 

작업대종료시에 모든 창문이 닫긴 후에 호출되는 


down 

메쏘드이다. 현재의 응용프로그람의 상태를 보존하 
거 나 초기 화처 리 의 후처리 등에 사용한다. 


표 14-2. 

작업대창문의 수명사건에 관한 갈구리메쏘드 


메쏘드이 ■ 

설 명 

인 수 


preWindow 

Open 


fill Action 
Bars 


postWindow 

Restore 

postWindow 

Create 


openlntro 

postWindow 

Open 


WorkbenchWindow 클라스의 구성자에서 호 
출되는 메쏘드 이다. 창문이 차림표띠를 가지 
는가 안가지는가 하는 설정을 할 때 등에 사 
용한다. 

preWindowOpen 메 쏘드의 완료 후에 인 차 
호출되는 메쏘드이다. 차림표띠나 도구띠의 
코드작성을 하는 부분이다. 숙련될 때까지는 
다루기가 어렵 다. 

보존된 상태로부터 창문을 복귀시킬 때 사용 
되는 메쏘드이다. 복귀시키지 않을 때에는 사 
용하지 않는다. 

창문이 보존된 상래 에 서 복귀 한 직 후나 새 로 
창문이 작성된 후에 호출되는 메쏘드 이 다. 그 
터나 이 메쏘드가 호출된 시점에서는 아직 창 
문이 열 려 있지 않다는데 주의한다. 

내 부부품을 작성할 때 창문이 열린 직 후에 호 
출되는 메쏘드 이다. 

작업 대 창문이 열린 직 후에 호출되 는 메 쏘드이 
다. 창문안의 화면부분품을 약간 변경시키는 
데 사용한다. 또한 목록으로 제목을 설정 하고 
창문의 크기 를 설 정하는 경 우에 사용한다. 


IWorkbenchWindow 

Configure 

IWorkbenchWindow 
IActionBarConfigu reF 
lags 

Iworkbench 

WindowConfigure 

IWorkbenchWindow 

Configure 

IWorkbenchWindow 

Configure 

IworkbenchWindow 

Configure 
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preWindow 

ShellClose 


postWindow 

Close 


작업 대 창문 ( SWT 의 Shell 클라스의 대 면 ) 이 
닫기기 전에 호출되 는 메 쏘드이 다. 〈〈 정 말로 
창문을 담겠습니 까?》등의 대 화칸을 현시하 
려는 경우에 사용한다. 

작업대창문이 닫긴 후 호출되는 메쏘드이다. 
preWindowOpen 에 서 진행 한 작업 의 후처 리 
등에 사용한다. 


IWorkbenchWindow 

Configure 


IWorkbenchWindow 

Configure 


표 14-3. 

작업대의 사건순환에 관한 메쏘드 



메쏘드이 ■ 

설 명 


인 수 

eventLoop 

Exception 

사건순환안에서 예상치 않았던 례외가 
때 호출되는 메쏘드이다. 일반적으로 
진행 한다. 

발생되였을 
로그기록을 

Throwable 

eventLoop 

Idle 

사건순환에서 아무것도 하지 않는 경우 Display 에 
서 호출되는 메쏘드이 다. 

Display 


작업대는 보통 Eclipse 를 기동했을 때 한번만 펼쳐진다. Eclipse 를 기동했을 때 우 
리가 볼수 있는것은 작업대창문이다. 작업대창문은 차림표띠의 [ Window ] ᅳ [New 
Window ] 을 선택하여 마음대 로 작성할수 있 다. 그러 나 작업 대 자체 는 반드시 하나의 응 
용프로그람에 하나밖에 작성할수 없 다. 종합적 으로 말한다면 응용프로그람과 작업 대 의 
관계는 1대1의 관계 이지 만 작업대와 작업대창문사이의 관계는 1대 다수의 관계 이라고 
할수 있다. 그러므로 표 14-2 의 작업대창문의 수명사건에 관한 메쏘드들은 작업대창문 
을 띄운 회수만큼만 호출되는것으로 된다. 

이제는 RssrAdvisor 클라스의 원천코드를 작성 해본다. 

먼저 getlnitialWindowPerspectiveld 메쏘드이 다. 이 메 쏘드는 WorkbenchAdvisor 
클라스의 유일 한 추상메 쏘드이 다. 최 초의 작업 대 창문을 위한 투시 의 ID 를 돌려 주기 위 
한 메쏘드이다. 

이 메쏘드는 응용프로그람이 시작되면서 작업대가 작성될 때 호출된다. 목록 14-10 
은 RssrAdvisor 클라스에서 메쏘드의 적용이다. 

목록 14-10. getlnitialWindowPerspectiveldtHI^E 

public String getlnitialWindowPerspectiveld () { 
return MainPerspective . class . getNameO ; 


견본응용프로그람에서는 클라스의 이름과 끼워 넣기로부터 식별되는 ID 가 동일하게 
되 여 있으므로 이 견본응용프로그람의 유일한 투시 인 MainPerspective 클라스의 이 름을 
돌려 준다. 
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다음으로 작업대，작업대창문의 수명사건에 관한 메쏘드를 차례로 해설한다. 

RssrAdvisor 클라스의 preStartup 메 쏘드와 preShutdown 메 쏘드는 우의 표에서 
본바와 같이 작업대수명사건에 관한 메쏘드이다. 각각 최초의 창문이 열리기 전에 호출 
되 는 메 쏘드와 사건순환완료 후 창문이 모두 닫기기 전에 호출되 는 메 쏘드이 다. 이 견본 
응용프로그람을 시 작하는데 따라 전후처 리 를 수행 하고있 다. 

다음에 preWindowOpen 메 쏘드의 적용을 목록 14-11 에 보여 준다. 

목록 14-11. preWindowOpen 메쏘드 

public void preWindowOpen 

(IWorkbenchWindowConfigurer configurer ) { 
super . preWindowOpen ( configurer ) ； 
configurer . setlnitialSize(new Point ( 

Preference . WORKBENCH — WIDTH . getlntO ， 

Preference . WORKBENCH _ HEIGHT . getlntO )) ； 
configurer . setTitle (" RSSR M ); 
configurer . setShowCoolBar ( false ); 


목록 14-12 를 살펴본다. 여기서는 작업대창문을 열기 전에 640 X 480 으로 창문크기 
를 설정한다. 이 창문의 너 비 640과 높이 480자체 의 수자는 Preference 클라스에서 정 
의 하고있다. 640，480이 라는 수자가 설정되 여있으며 이 클라스에서는 [ Feed ] 보기의 놓임새 
의 수값들도 설정되여 있다. 이렇게 응용프로그람에서 리용하는 상수는 Preference 클라스 
등 상수를 다루는 클라스를 만들어 관리하면 편리하다. 

또한 이 작업대창문의 제목도 설정하고있다. 

목록 14-13 의 fillActionBars 메 쏘드는 preWindowOpen 메쏘드완료 후 인차 호출 
되는 메쏘드이다. 이 메쏘드안에서 호출되고있는 비공개메쏘드인 fillMenuBar 메쏘드로 
차림표띠에 《 File 》 차림표와 《 Open 》 차림표를 만들고있다. 

목록 14-12. Preference 클라스에서 작업대창문의 설정부분 

public class Preference { 


/** 작업대창문의 폭*/ 

public static final Preference WORKBENCH_WIDTH 
= new Preference (" WorkbenchWidth M , ”640”); 

/** 작업대창문의 높이 */ 
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public static final Preference WORKBENCH 一 HEIGHT 
= new Preference( f 'WorkbenchHeight", ”480”); 


14-13. fillActionBarsIHI^E 

public void fillActionBars (I Workbench Window window, 
IActionBarConfigurer configurer, int flags) { 
super. fillActionBars (window, configurer, flags); 
if ((flags & FILL_MENU_BAR) 卜 0) { 
fillMenuBar(window, configurer) ； 


/** 차림표띠의 구축 */ 

private void fillMenuBar(IWorkbenchWindow window, 

IActionBarConfigurer configurer) { 
IMenuManager menuBar = configurer. getMenuManagerO : 
menuBar. add (createFileMenu (window)) ； 
menuBar. add (createWindowMenu (window)); 


목록 14-14 의 postWindowOpen 메 쏘드는 작업 대 창문이 열 린 직 후에 호출되 는 메 
쏘드이다 . 여기서 [Feed] 보기의 계층구조에서 RSS 제공을 한개 선택하면 기사보기에 기 
사일람이 표시되도록 setupFeedsViewListener 메 쏘드를 호출하여 감시자를 등록한다 . 

목록 14-14, postWindowOpen 메쏘드 

public void postWindowOpen 

(IWorkbenchWindowConfigurer configurer) { 
super. postWindowOpen (configurer); 

//계 증구조에서 제공을 선택 할 때마다 기사일 람이 나오게 하는 감시 자를 등록 
setupFeedsViewListener () ; 

//기 사일 람에 서 기 사를 선택할 때 마다 편집 기 (SWT 열 람기 )로 열 리 도록 감 
시 자를 등록 

setupItemsViewListener () ； 


setupFeedsViewListener 메 쏘드를 보기 로 한다 . 여 기 서 는 [Feed] 보기 로부터 
JFace 의 Tree Viewer (계층구조를 표시 하는 보기 ) 를 얻고 계층구조의 어느 요소가 선택 
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되였는가를 알아내는 감시자를 등록한다(목록 14-15). 

목록 14-15. setupFeedsView 니 stener 메쏘드 


* 제 공일 람에 서 제 공을 선택 하면 

* 입 구점 이 입 구점일 람에 표시 되 도록 설정한다 . 

*/ 

private void setupFeedsViewListener () { 

TreeViewer treeViewer = RssrApplication. getFeedViewO. getViewer () : 
treeViewer. addSelectionChangedListener 
(new ISelectionChangedListener () { 
public void selectionChanged(SelectionChangedEvent event) { 
StructuredSelection ss = 

(StructuredSelection) event. getSelection 0 ； 
RssrApplication. getltemViewO. getViewer (). 
setlnput (ss. getFirstElement 0) ； 

} 

})； 


setupItemsViewListener 메 쏘드에 서 는 [기 사 ] 보기 에 서 선택한 기 사에 로의 련결 을 
RSS 제공용의 서고인 Rome 으로부터 얻는다 . 그리고 거기서 얻어진 Web 폐지에로의 련 
결을 리용하여 편집기 RssBrowser 를 열기 위한 감시자를 등록한다 . (목록 14-16) 

목록 14-16. setupItemsViewListener 머 I 쏘드 

private void setupItemsViewListener () { 

RssrApplication. getltemViewO. getViewer (). addOpenListener ( 
new IOpenListenerO { 

public void open (OpenEvent event) { 

IStructuredSelection selected = 

(IStructuredSelection) event. getSelection (); 
final SyndEntryl entry = (SyndEntryl) selected. getFirstElement 0 ； 
try { 

IWorkbenchPage activePage = 

PlatformUI. getWorkbench 0. getAc 仕 veWorkbenchWindowO 
. getActivePageO; 

activePage. openEditor(new UrlEditorInput( 
entry. getTitle0 ， entry. getLink ()) ， 

RssBrowser. class. getName 0); 
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History Manager. getlnstanceO. read (entry. getLinkO); 
RssrApplication. getltemViewO. getViewerO. refresh (); 
} catch (Exception e) { 
log. error (e, e); 
return ； 


})； 


eventLoopException 메 쏘드는 창문처 리 의 기 본순환내 에 서 처 리 되 지 않은 례 외 가 
발생할 때 호출되는 메 쏘드이 다 . 여 기서 는 오유를 기 록하게 한다(목록 14-17). 

목록 14-17. eventLoopExceptiontHI^E 

public void eventLoopException (Throwable exception) { 

log. error( M Unhandled event loop exception", exception) ； 


14.4.4. MainPerspective.java 

Eclipse RCP 의 응용프로그람에서 는 기 정 투시 를 반드시 정 의하여 야 한다 . 견본응용 
프로그람에서는 MainPerspective 가 그에 해당된다 . 

MainPerspective 와 관련된 plugin.xml 의 끼워넣기명시(목록 14-18) 를 본다 . 

목록 14-18. MainPerspective 와 관련된 끼워널기명시 

〈extension point=”org. eclipse, ui. perspectives ”〉 

〈perspective 

class=”rctf. rssr. MainPerspective" 

fixed= ? 'true M 

name=’’RSS 열람 ” 

id=”rctf. rssr. MainPerspective ’’/〉 

〈 /extension 〉 


이 MainPerspective 는 확장점인 《 org.eclipse.ui.perspectives 》 를 확장한다 . 또 
한 중요한것 은 perspective 요소의 fixed 속성 이 다 . 이 속성 에 참을 설정 하면 투시 의 놓 
임새 가 고정되 고 투시안에서 보기 의 이동이 나 닫기 가 불가능해 진다 . 

이번 견본응용프로그람에서도 [Feed] 보기와 [ 기사]보기가 닫기면 프로그람적인 불 
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안정 이 생 기 므로 fixed 속성 을 참으로 지 정한다 . 

MainPerspective 클라스의 원천코드를 본다(목록 14-19). 

목록 14-19. MainPerspective 클라스 


public class MainPerspective implements IPerspectiveFactory { 
public void createlnitialLayout (IPageLayout layout) { 
layout. setEditorAreaVisible(true); 

String editorArea = layout. getEditorArea0 ； 
layout, add View (Feed View, class. getNameO ， 

IPageLayout. LEFT, Preference. FEED_VIEW_ 

LAYOUT_RATIO. getFloatO ， editorArea) ； 
layout.addView(EntryView.class.getNameO ， IPageLayout. TOP, 
P reference. ENTRY_VIEW_LAYOUT_RATIO. getFloat 0 ， editorArea) ； 


투시를 확장할 때 확장점에 정의되여있는 대면인 IPerspectiveFactory 를 실현한다 . 
createlnitialLayout 메쏘드의 적용에서는 단순히 보기를 어떻게 배치하겠는가를 정의한다 . 

14.4.5. 보기관련들라스 

이 프로그람에서는 2 개의 보기 즉 [Feed] 보기와 [ 기사]보기를 정의하고 사용하고있 
다 . 목록 14-20 에 보기와 관련한 plugin.xml 안의 끼워넣기명시를 보여준다 . 


목록 14-20. 보기와 관련한 끼워널기명시 

〈extension point=”org. eclipse, ui. views ’’〉 
<view 

allowMultiple= "false” 
class="rctf. rssr. Feed View" 
category=”rctf. rssr” 
name=’’ 제 공 ” 

id="rctf. rssr. FeedView ’’/〉 
<view 

class= n rctf. rssr. EntryView" 
category’rctf. rssr” 
name: ，，기사 ，’ 

id=”rctf. rssr. Entry View ’’/〉 


〈category 
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name= ， ’RSSR n 
id=’’rctf. rssr ”/〉 
〈 /extension 〉 


보기는 확장점으로《 org.eclipse.ui.views 》 를 확장하여 작성한다 . view 요소안에 
서 보기를 정의한 클라스의 이 름과 id 를 지정한다 . 

Category 요소에 서 보기 를 분류하는 범 주 《 RSSR 》 를 정 의한다 . 그 범 주에 각 보 
기 가 속하여있는데 view 요소의 category 속성 에 서 부류 ID 를 서 술하여 지 정한다 . view 
속성의 allowMultiple 속성은 여러개의 보기를 펼치겠는가 아니면 하나만 펼치겠는가를 
결정하는 속성 이 다 . 기정 은 《 false 》 로 되 여있다 . 

[Feed] 보기 를 리 용하여 《 RSS 제 공을 그롭화하는 서 류철》이 나《 RSS 제 공자체》를 
사용자가 조작한다 . 그러나 실제로 RSS 제공의 URL 이나 RSS 제공정보는 Feed 클라스 
에 서 관리 하고 RSS 제 공을 그룹화하는 서 류철정 보는 FeedGroup 클라스가 관리한다 . 또 
한 Feed 클라스와 FeedGroup 클라스를 통일적 으로 다루기 위 하여 Node 대면을 정의 하 
고있다 . 이러한 클라스군은 보통 령역객체나 모델객체라고 부른다 . 

실제 로 정 보를 관리하는 모델객 체 와 사용자의 조작접 수， 겉 보기 를 제 공해 주는 
[Feed] 보기를 결합할 필요가 있다 . 이 결합을 해주는것이 JFace 의 추상클라스인 
Viewer 클라스를 계승한 어떤 하위클라스이 다 . 

Viewer 의 하위클라스에서 자주 리용되는것이 계층구조의 겉모양을 가진 
Tree Viewer, 일람형식의 겉모양을 제공하는 ListViewer, 그리고 표형식의 
TableViewer 이다 . 이번 견본프로그람은 [Feed ] 보기에서는 TreeViewer, [ 기사]보기 
에서는 TableViewer 를 사용한다 . 

TreeViewer 는 ILabelProvider 대면을 실현한 클라스와 ITreeContentProvider 
를 실현한 클라스를 같이 사용한다 . [Feed ] 보기에서는 ITreeContentProvider , 
FeedTreeContentProvider 클라스와 iLabelProvider 대면을 실현한 FeedTreeLabelProvider 
를 TreeViewer 와 같이 사용하고있다 . 

FeedTreeLabelProvider 클라스자체는 모델객체 (Feed 클라스나 FeedGroup 클라스 
등)와 [Feed] 보기의 계 증구조에 있는 아이론이나 본문문자렬을 붙여 야 한다 . 

FeedTreeContentProvider 는 TreeViewer 에 대한 입 력으로 되는 모델객체，또는 
모델객체의 집합과 TreeViewer 자신이 내부에 가지는 목록구조의 대응을 제공해준다 . 

[Feed ] 보기에서는 FeedViewSorter 클라스를 제공이나 제공그롭을 정돈할 때 사용하 
고있다 . JFace 의 정돈을 하고싶을 때 에는 ViewerSorter 클라스를 계승한 클라스를 정의하 
여 사용한다 . 그것이 FeedViewSorter 클라스이다 . 

그림 14-21 에 모델객체와 TreeViewer 와 관련된 클라스와의 관계를 보여준다 . 
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제 공의 내 용 ( Feed ) 이 나 제 공의 그룹화 ( FeedGroup ) 등을 다루는 
모형 객 체 Node 대면을 리 용하여 통일적 으로 취급한다. 



그림 14-21. FeedView 클라스와 관련된 클라스무리 

[ 기사 ] 보기는 Entry View 클라스에서 실현되여있지만 TreeViewer 에서가 아니라 
표형식의 겉모양을 제공하는 TableViewer 를 사용하고있다 . 이 TableViewer 와 
EntryViewContentProvider 클 라스， EntryViewLabelProvider 클라스와 협 동하여 
기 사일 람을 표시한다 . 

EntryViewLabelProvider 클라스는 ITableLabelProvider 대면과 동시에 IFontProvider 
대면도 실현하고있다 . 이렇게 하여 실제로 선택된 기사이외는 굵은 글자로 표시되고 선 
택된 기사는 보통의 얇은 글자로 표시되도록 하였다 . 이장에서는 JFace 를 구체적으로 
소개하는것 이 목적 이 아니 므로 이 정 도로 설명 을 한다 . 

14.4. 6. 편집 기 관련들라스 (RssBrowser 클라스 ) 

RssBrowser 클라스는 [기 사 ] 보기 에 서 선택 한 기 사를 열 람하기 위 한 편집 기 를 실현 
한 클라스이 다 . 편집기와 관련된 끼워넣기명시를 본다(목록 14-21). 
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목록 14-21. 편집기와 관련한 끼워넣기명시 

〈extension 

point=”org. eclipse, ui. editors "〉 
<editor 

icon="icons/f ile_obj.gif’ 
class="rctf. rssr. RssBrowser” 
name=’’RSS 열람기 ’’ 
id=’’rctf. rssr. RssBrowser ”/〉 
〈 /extension 〉 


편집 기 를 만들기 위 하여 확장점 인 org. eclipse, ui. editors 를 확장하였 다 . editor 요 
소의 class 속성에서 실제로 편집기를 만드는 클라스인 RssBrowser 클라스의 이름을 지 
정하고있 다 . 

목록 14-22 에 RssBrowser 클라스 실현의 일부를 보여주었다 . 확장점에서 정의된 
대면 iEditorPart 를 실현한 클라스 EditorPart 를 계승하고있다 . 이 클라스는 편집기라 
고 해 도 SWT 상에 서 Window 의 OLE 를 리 용하여 Internet Explorer 를 표시 하는 
Browser 클라스로 실현된다 . 이 Browser 클라스는 사용방법이 아주 간단하여 SWT 의 
화면부분품에 설정한후 Browser 클라스의 대면에 대하여 setUrl (실제의 URL) 을 지정 
하는것으로 쉽게 Web 상의 폐지를 현시해준다 . Browser 클라스는 간단히 사용할수 있기 
때문에 각종 Eclipse RCP 응용프로그람의 교육용으로 사용되고있다 . 

목특 14-22. RssBrowser 클라스 ( 일부 ) 

public class RssBrowser extends EditorPart { 
private Browser browser ； 

public void createPartControl (Composite parent) { 
browser = new Browser (parent, SWT. FILL) : 

UrlEditorlnput uei = (UrlEditorlnput) getEditorlnput 0 ； 
browser. setUrl (uei. getUrl ()) ； 


14.4.7. 설정대화칸관련들라스 

그러면 마지막으로 설정대화칸에 대하여 보기로 한다 . 이 설정대화칸은 일반적으로 
차림표띠의 [Window] ᅳ [Preference] 을 선택 하여 나오는 폐지 이다 . 이 책 에서도 이 
설정대화칸을 리용하여 Eclipse 의 여러가지 설정을 진행하였다 . 이번 견본프로그람에서 
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는 설정대화칸에서 설정을 한 대로 작성한다 . 우선 끼워넣기명시를 본다(목록 14-23). 
설정 대 화칸은 확장점 《 org.eclipse. ui.preferencePages 》 에 대 하여 확장을 진행 하는 
것 으로 작성한다 . page 요소의 클라스속성 에 실제 로 설정 대 화칸을 실현하는 클라스의 이 
틈을 서술한다 . 


목록 14-23. 설정대화칸과 관련한 끼워널기명시 

〈extension 

point=’’org. eclipse, ui. pref erencePages M > 
<page 

class="rctf. rssr. RssrPreferencePage" 
name=’’RSSR 설정 ’’ 

id= n rctf. rssr. RssrPreferencePage ”/〉 
〈 /extension 〉 


목록 14-24 에서 이 견본프로그람의 설정대화칸을 실현하는 RssPreferencePage 클 
라스를 보여주었다 . 

목록 14-24. RssPreferencePage 

public class RssrPreferencePage extends 

FieldEditorPreferencePage implements IWorkbenchPreferencePage { 
public RssrPreferencePage0 { 

super (FieldEditorPreferencePage. FLAT); 

setPreferenceStore(RssrPlugin. getlnstanceO. getPreferenceStoreO ； 

} 

public void init(IWorkbench workbench) {} 
protected void createFieldEditors () { 

addField(new FileFieldEditor (Preference. LOG4J_CONFIGURATION. key 0 ， 

M label ： log4jp M , getFieldEditorParent0)); 
addField(New DirectoryFieldEditor(Preference. RSSR_DIR. key 0, 
"label ： rssrdir M , getFieldEditorParent0)); 


구성 자에 서 setPreferenceStore 메 쏘드를 사용함으로써 자동적 으로 설 정 내 용을 
Eclipse 를 기동하고있는 콤퓨터에 보존하고있다 . 또다시 기동할 때에는 자동적으로 이 
설정내 용을 읽 어 낸다 . 이 렇게 PreferenceStore 는 설정내용을 보존할 때 에 아주 편리하 
게 사용할수 있다 . 
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FieldEditor 는 설정대화칸안에서 하나의 설정을 진행하기 위한 마당을 정의한다 . 
createFieldEditors 메쏘드에서는 실제로 설정 파일의 항목 (label:log4jp ， label : rssrdir ) 을 
등록한다 . 


제5절. 견본응용프로그람의 독립형기동 

지금까지는 Eclipse 우에서 실행대화칸을 리용하여 기동하였지만 Eclipse RCP 는 최 
소로 필요한 끼워넣 기와 Eclipse 부속의 startup, jar 가 있으면 단독으로 기동할수 있다 . 

그러 면 우선 독립 형 기 동을 위한 순서 에 대 하여 설 명한다 . 

사실 Eclipse3. 0.1 단계 에서는 Eclipse RCP 용의 반출기능이 아직까지 존재 하지 않 
는다 . 그러므로 SampleChapl4.2 를 끼워넣기와 같이 배포용으로 반출하여 필요한 끼워 
넣기를 Eclipse 의 설치등록부안에 있는 Plugins 등록부로부터 수동으로 복사한다 . 물론 
Eclipse 의 설치등록부안에 있는 startup, jar 도 수동으로 복사한다 . 

앞으로 Eclipse 에서의 이러한 수동작업을 편리하게 하는 Eclipse RCP 용 배포조수 
도 등장할것이다 . 사실상 이 책을 집필하는 과정에도 여러번 부주의로 독립형기동이 실 
패 하였 다 . 

14.5.1. SampleChapl4.2 의 반출 

처 음에 SampleChapl4. 2 프로젝 트를 Eclipse 용끼 워 넣 기 로 반출한다 . 그러 나 우선 
끼워넣기 로 동작시키는데 필요한 프로젝트안의 등록부를 선택 하여 야 한다 . [Package 
Explorer] 안의 SampleChapl4. 2 프로젝 트에 있는 plugin.xml 을 두번찰칵하여 열 고 
[Build ] 폐지를 연다 . 왼쪽아래에 [Binary Build] 라는 부분이 있는데 3 개의 등록부 
etc, icons, lib 와 plugin, xml 의 검 사칸을 선택 한다(그림 14-22 ). 이 조작을 하면 끼 
워넣기로 반출할 때에 우에서 지정한 등록부가 포함되는것으로 된다 . 반대로 이 조작을 
하지 않으면 필요한 서고나 아이콘파일이 포함되지 않아 프로그람이 기동하지 못하므로 
주의 해 야 한다 . 

[Package Explorer] 에 서 SampleChapl4. 2 프로젝 트를 마우스오른쪽단추로 찰칵하 
고 [Export ] 을 선택하면 [Export ] 조수가 기동한다 . [Export ] 조수에서 [Export P 
lug-ins and Fragments] 대화칸의 [Avaliable Plug-ins and Fragments] 가 표시 되 
는데 그림 14-23 와 같이 [Export Options ] 에서 [a directory structure ] 를 선택하고 
[Directory] 에 [/kut/eclipse/chapl4/SampleChapl4. 2] 을 지 정 한다 . 

이 렇게 [/kut/eclipse/chapl4/SampleChapl4.2] 이 하의 등록부가 작성되고 그안에 
끼워넣기가 복사된다 . [Finish ] 를 1 찰칵하면 반출이 진행된다 . 
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그림 14-22. 등록부와 파일의 선택대화칸 



그림 14-23. 끼워넣기의 반출조수 

14.5.2. startRssr.cmd 의 작성 

다음은 견본프로그람의 독립 형 기 동에 필요한 파일 startRssr. cmd 를 준비 한다 . 목 
륵 14-25 와 같은 파일 을 작성 하고 [/kut/eclipse/chapl4/SampleChapl4. 2] 등록부밑 
에 복사한다 . 
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목록 14-25. startRssr.cmd 


echo on 
setlocal 


cd %~dpO 

javaw cp startup, jar org. eclipse, core, launcher. Main 
tf.rssr. RSSR 
endlocal 


application rc 


14.5.3. 기동에 필요한 끼워넣 기를 수동으로 복사 

그림 14-24 에서 기동에 필요한 파일구성에 대하여 보여준다 . 그림으로부터 알수 있 
는바와 같이 Eclipse 설치등록부의 plugins 등록부안에서 부터 필수끼워 넣기등록부를 
[/kut/eclipse/chapl4 / SampleChapl4. 2/plugins] 등록부에 복사한다 . 여 기 서 주의 
하지 않으면 안되는것 이 org.eclipse.update.configurator 끼워 넣기 이 다 . 이 끼워 넣기 
는 Eclipse 로부터 기동할 때 에는 지정하지 않아도 되지만 독립형기동할 때 에는 
plugins 등록부에 있는 끼워넣기의 plugin.xml 을 읽 어낼 때 반드시 필요한것 이므로 복 
사한다 . 

마지 막으로 Eclipse 설 치 등록부에 있 는 startup, jar 를 [/kut/eclipse/chapl4 / 

SampleChapl4.2] 등록부아래에 복사한 다음 준비를 완료한다 . 

SampleChapM.Z 
:3- plugins 

+ ■■ orgteclipse.con^expressions-lO 성 

+ ■■ org ,ec I i ps e. c ore. ru nti me_3.0.1 

♦■强，— e C ip5e t help_3 요 0 
f © org.ec I i p se.jface_3.0.0 
I: org .ec I i p se. osgi_3 B 0-1 

f: f-P org .ec I i p se. swt_3.0-1 

org.-eclipse.swt.nll.B.O.l 
+ ■■ 上: org. e c I i p se t s wt. wi n 3 2 _ 3 1 0.1 
[ + ■- : j org.eclipse.ui_3.0.1 

+ ■■ org.eclipse.ui.workbench.nll_3.0.1 

I +■■ ■ 上 ‘ org.eclipse.update.configurator.B.O.O 

I ： rctf.rs5r_0.0.1 

h startRssr.cmd 

[ 티 #：■' startup jar 

그림 14-24. 독립형기동할 때에 등록부구조 
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startRssr.cmd 를 두번 찰칵하여 기동시켜 본다 . 기동하지 않는 경우는 
[/kut/eclipse/chapl4 / SampleChapl4. 2/configuration] 등록부안에 기 륵파일 이 작 
성 되 므로 참조한 다음 정 확히 기 동하도록 수정한다 . 
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